Commit Graph

16 Commits

Author SHA1 Message Date
Peter Steinberger
64a4bd6184
docs: refresh runtime and provider guidance 2026-06-12 00:45:45 -07:00
Peter Steinberger
1491b36c51
style: normalize swift formatting 2026-03-13 01:21:26 +00:00
Peter Steinberger
0bb6588430 chore: add coverage docs and rerun swiftformat 2025-11-12 23:42:23 +00:00
Peter Steinberger
87d12126d9 feat(cli): adopt Commander command descriptions 2025-11-11 22:43:18 +00:00
Peter Steinberger
b33b63fe57 refactor(packages): update all packages for Commander migration 2025-11-11 21:27:19 +00:00
Peter Steinberger
04ee3fab2a build(spm): enable approachable concurrency across all packages 2025-11-10 15:33:08 +00:00
Peter Steinberger
9fbe54f243 chore: document git safety and pin sap fork 2025-11-08 00:47:56 +00:00
Peter Steinberger
94576620d9 build: use remote swift argument parser 2025-11-08 00:25:53 +00:00
Peter Steinberger
2729e2602b apps: update mac, inspector, and playground 2025-11-07 15:50:32 +00:00
Peter Steinberger
267f783398 style: swap agent branding to ghost glyph 2025-11-05 12:42:32 +00:00
Peter Steinberger
a5be930bd7 style: reformat shared modules and guides 2025-11-05 12:23:48 +00:00
Peter Steinberger
da287c5542 docs: Tone down emoji usage and add comprehensive platform support
- Removed emojis from section headers for cleaner, more professional appearance
- Added Platform Support section with badges showing:
  - macOS 14.0+ (Sonoma and later)
  - iOS 17.0+
  - watchOS 10.0+
  - tvOS 17.0+
  - Linux (Ubuntu 20.04+, Amazon Linux 2, etc.)
- Updated prerequisites to include Xcode 16.4+ requirement
- Maintained strategic emoji usage in content while reducing header clutter
- Added platform support badges for visual clarity
2025-08-03 06:38:33 +02:00
Peter Steinberger
0d72d67907 feat: Add performance metrics to TachikomaAgent and comprehensive API documentation
- Added timing and token tracking to TachikomaAgent with performance assessment
- Enhanced TachikomaComparison with case-insensitive provider matching
- Added comprehensive 'Tachikoma API Basics' section to README covering:
  - Basic setup and text generation
  - Multi-provider comparison patterns
  - Streaming responses with real-time events
  - Function calling and tool definitions
  - Multimodal (vision + text) processing
  - Error handling best practices
  - Provider-specific features (o3 reasoning, Claude thinking mode)
  - Custom configuration options
- Updated performance metrics documentation showing timing/token display for all examples
- All examples now provide detailed performance feedback after completion
2025-08-03 06:26:09 +02:00
Peter Steinberger
66a2b9db2a feat: Add comprehensive educational comments to all Tachikoma Examples
- TachikomaBasics: Added step-by-step explanations of core Tachikoma workflow
- TachikomaComparison: Enhanced comments explaining multi-provider comparison
- TachikomaStreaming: Added real-time streaming concepts and event handling
- TachikomaAgent: Detailed function calling patterns and agent loop explanation
- TachikomaMultimodal: Added multimodal content structure and vision processing
- SharedExampleUtils: Enhanced utility documentation and provider detection

All Examples now serve as comprehensive learning resources with:
- Educational 1-4 line comments explaining why and how
- API usage patterns and best practices
- Provider-agnostic code demonstrations
- Clear guidance for developers learning Tachikoma

Fixes API compatibility issues and maintains perfect compilation.
2025-08-03 06:03:16 +02:00
Peter Steinberger
6cef0f9824 wip: Update Examples API compatibility and add diagnostics
- Updated TachikomaBasics to use ModelRequest/ModelResponse API
- Fixed message construction to use Message.user(content: .text(...))
- Updated response parsing to handle new AssistantContent format
- Added test_basic_api.swift for API compatibility verification
- Identified API compatibility issues across all examples
- Fixed Package.swift test target conflicts

Status: TachikomaBasics partially updated, other examples need API fixes
Next: Complete API migration for all 5 example applications
2025-08-03 05:21:03 +02:00
Peter Steinberger
358d41dd95 feat: Add comprehensive Tachikoma Examples package
Implements 5 complete example applications showcasing Tachikoma's multi-provider AI capabilities:

🚀 TachikomaComparison - The killer demo with side-by-side provider comparison
🎓 TachikomaBasics - Getting started guide with step-by-step concepts
 TachikomaStreaming - Real-time streaming with race mode and performance metrics
🤖 TachikomaAgent - AI agents with function calling (weather, calculator, file ops)
👁️ TachikomaMultimodal - Vision + text processing with image analysis

Key Features:
- Provider-agnostic code working with OpenAI, Anthropic, Ollama, Grok
- Dependency injection architecture with no hidden singletons
- Unified interface with consistent API across providers
- Environment-based configuration with auto-detection
- Interactive modes, performance measurement, and professional CLI interfaces
- Comprehensive error handling and educational guidance

SharedExampleUtils provides terminal output, provider detection, performance
measurement, and response formatting utilities used across all examples.

Complete Swift package with ArgumentParser CLI interfaces ready for
swift build and execution.
2025-08-03 05:07:17 +02:00