Last Updated: April 2026
Version: v1.0.0 (in development)
Strategy: All components marked as “In Development” until exhaustive testing validates them
Status Definitions
Available
Implemented, tested, and production-readyPromoted after passing all SDK tests and successful use in external agents
Beta
Implemented but may have limitationsBasic tests pass, known limitations documented
In Development
Code exists, testing in progressDefault status until validation is complete
Planned
Designed but not yet implementedSpec exists, implementation not started
Future
Under consideration for future versionsIdea stage, no spec yet
Component Status Strategy for v1.0.0
Approach: Conservative status labeling to ensure quality and reliability
Promote to Beta
Requirements:
- SDK interface tests pass
- Basic functionality validated
- Known limitations documented
Promote to Available
Requirements:
- Comprehensive testing complete
- Used successfully in external agent (e.g., EMR agent)
- No known critical issues
Core Agent System
Agent Base Class
@tool Decorator
AgentConsole
SilentConsole
ApiAgent
MCPAgent
DatabaseMixin
AvailableStdlib-sqlite3 mixin for agent-owned persistent state (
src/gaia/database/).View Specification →RoutingAgent
Chat & LLM
- Agent SDK
- LLM Clients
AgentSDK
AgentConfig
quick_chat
RAG (Document Q&A)
RAGSDK
AvailablePDF indexing and question answering
RAGConfig
AvailableRAG system configuration
quick_rag
AvailableOne-off RAG queries
Audio & Voice
AudioClient
AvailableComplete voice interaction system
WhisperAsr
AvailableSpeech-to-text with Whisper
KokoroTTS
AvailableHigh-quality text-to-speech
API Server
create_openai_app
AvailableFastAPI server generator
SSEOutputHandler
AvailableServer-sent events streaming
API Schemas
AvailablePydantic models for OpenAI API
MCP Integration
MCPAgent
AgentMCPServer
Plugin System
Agent discovery is live: the Agent UI server uses
AgentRegistry with YAML
manifests under ~/.gaia/agents/. The OpenAI-style API server uses a separate
hardcoded AGENT_MODELS dict.AgentRegistry (Agent UI)
Available
src/gaia/agents/registry.py — scans built-ins + ~/.gaia/agents/.AGENT_MODELS (API server)
AvailableStatic model registry in
src/gaia/api/agent_registry.py.Testing Utilities
MockLLMProvider
In DevelopmentMock LLM for testing - Issue #9
MockVLMClient
In DevelopmentMock vision model - Issue #9
create_test_agent
In DevelopmentTest agent factory - Issue #9
temp_database
In DevelopmentTemporary database fixture - Issue #9
Utilities
FileChangeHandler
In DevelopmentFile system monitoring - Issue #2
get_logger
AvailableStructured logging utility
PathValidator
AvailablePath security validation
Tool Mixins
Tool mixins extend agent capabilities with reusable functionality
FileToolsMixin
AvailableFile read/write operations
RAGToolsMixin
AvailableDocument search and retrieval
ShellToolsMixin
AvailableShell command execution
FileSearchToolsMixin
AvailableAdvanced file search capabilities
Configuration (Future)
Centralized configuration system is planned for a future release
GAIAConfig
PlannedGlobal configuration - Issue #5
get_config
PlannedConfig getter - Issue #5
set_config
PlannedConfig setter - Issue #5
Summary Statistics
Available
28 ComponentsProduction-ready
Beta
1 ComponentLimited testing
In Development
5 ComponentsActive work
Planned
6 ComponentsFuture releases
Component Status Reference - Last Updated: April 2026