How valgorithms/ai-router works
VZG Coders AI Router accepts a coding prompt through a CLI or OpenAI-compatible HTTP server, selects and invokes models, evaluates responses, escalates failures, and records metrics. Jev can influence initial model choice and judge response quality; without it, transport failures drive fallback. The graph preserves the model adapters and shared HTTP, configuration, evaluation, and result layers. Relationships for the CLI and API server rely on README/SOURCE INDEX evidence where their source was not excerpted; unsampled internals are not inferred.
Main entry points: Router.php Routing and escalation · Application.php Application setup · ModelResult.php Model result · Evaluator.php Response evaluator
Components 20
Entry points
- CLI
bin/ai-router - HTTP API server
src/Server/ApiServer.php - Application setup
src/Application.php
Routing and evaluation
- Routing and escalation
src/Router.php - Jev client
src/JevClient.php - Response evaluator
src/Evaluation/Evaluator.php - Evaluation result
src/Evaluation/EvaluationResult.php - Metrics store
src/Metrics/MetricsStore.php
Model adapters
- Model interface
src/Model/ModelInterface.php - Model result
src/Model/ModelResult.php - Ollama adapter
src/Model/OllamaModel.php - Claude adapter
src/Model/ClaudeModel.php - OpenAI adapter
src/Model/OpenAiModel.php - Copilot adapter
src/Model/CopilotModel.php
Shared support
- Environment config
src/Support/Env.php - HTTP client
src/Support/HttpClient.php
Other components
- Prompt user
- OpenAI-compatible client
- Jev service
- Model services
Connections 39
- Prompt user → CLI: submits prompt
README.md - CLI → Application setup: starts app
README.md - Prompt user → OpenAI-compatible client: sends chat
README.md - OpenAI-compatible client → HTTP API server: calls API
README.md - HTTP API server → Routing and escalation: dispatches request
src/Server/ApiServer.php - Application setup → Environment config: loads config
src/Application.php - Application setup → Routing and escalation: constructs router
src/Application.php - Application setup → Ollama adapter: configures
src/Application.php - Application setup → Claude adapter: configures optionally
src/Application.php - Application setup → OpenAI adapter: configures optionally
src/Application.php - Application setup → Copilot adapter: configures
src/Application.php - Application setup → Jev client: configures optionally
src/Application.php - Application setup → Response evaluator: constructs
src/Application.php - Application setup → Metrics store: constructs
src/Application.php - Routing and escalation → Jev client: chooses initial model
src/Router.php - Routing and escalation → Ollama adapter: attempts model
README.md - Routing and escalation → Claude adapter: escalates to
README.md - Routing and escalation → OpenAI adapter: escalates to
README.md - Routing and escalation → Copilot adapter: escalates to
README.md - Routing and escalation → Response evaluator: evaluates response
src/Router.php - Response evaluator → Jev client: judges response
src/Evaluation/Evaluator.php - Jev client → Jev service: requests decisions
src/JevClient.php - Routing and escalation → Metrics store: records attempt
src/Router.php - Response evaluator → Evaluation result: returns evaluation
src/Evaluation/Evaluator.php - Routing and escalation → Model result: uses result
src/Router.php - Response evaluator → Model result: evaluates result
src/Evaluation/Evaluator.php - Routing and escalation → Model interface: dispatches completion
src/Router.php - Ollama adapter → HTTP client: sends requests
src/Model/OllamaModel.php - Claude adapter → HTTP client: sends requests
src/Model/ClaudeModel.php - OpenAI adapter → HTTP client: sends requests
src/Model/OpenAiModel.php - Jev client → HTTP client: sends requests
src/JevClient.php - Ollama adapter → Model result: returns completion
src/Model/OllamaModel.php - Claude adapter → Model result: returns completion
src/Model/ClaudeModel.php - OpenAI adapter → Model result: returns completion
src/Model/OpenAiModel.php - Copilot adapter → Model result: returns completion
src/Model/CopilotModel.php - Ollama adapter → Model services: calls local model
README.md - Claude adapter → Model services: calls provider
README.md - OpenAI adapter → Model services: calls provider
README.md - Copilot adapter → Model services: runs CLI
README.md