How rakeshvarma007/codesense-doc-string-generator works
Nasiko is an AI-agent registry and orchestration platform. A user or operator submits requests through the API or CLI; the backend manages agent records, search, uploads, and orchestration, while the router selects an agent and forwards requests to deployed agents. Deployment commands flow through Redis to a Kubernetes build worker. The README also documents observability and integrations. Some branches are represented by their exact subsystem directories because their implementation files were not sampled; edges without direct evidence are omitted.
Main entry points: main.py FastAPI Backend · router_orchestrator.py Request Orchestrator · handlers API Handlers · service Platform Services
Components 25
Client Interfaces
- Nasiko CLI
cli/main.py
Platform API
- FastAPI Backend
app/main.py - API Routes
app/api/routes - API Handlers
app/api/handlers - Platform Services
app/service - Repositories
app/repository - MongoDB
- Search Index
app/service/redis_search_service.py - Auth Service
auth-service-oss/main.py - Chat History Service
agent-gateway/chat-history-service/main.py - Observability Services
app/service/observability_service.py
Agent Routing
- Router Service
agent-gateway/router/src/main.py - Request Orchestrator
agent-gateway/router/src/services/router_orchestrator.py - Agent Registry Client
agent-gateway/router/src/core/agent_registry.py - Routing Engine
agent-gateway/router/src/core/routing_engine.py - Agent Vector Store
agent-gateway/router/src/core/vector_store.py - Agent Client
agent-gateway/router/src/core/agent_client.py
Deployment Orchestration
- Orchestration Service
app/service/orchestration_service.py - Redis Command Stream
- Kubernetes Build Worker
worker/k8s_build_worker.py - Kubernetes
- Registry Manager
orchestrator/registry_manager.py
Agent Runtime
- Agent Services
agents - Translator Agent
agents/translator/src/engine.py
Other components
- User or Operator
Connections 26
- User or Operator → Nasiko CLI: uses
README.md - User or Operator → FastAPI Backend: requests
README.md - Nasiko CLI → FastAPI Backend: calls API
README.md - FastAPI Backend → API Routes: mounts
app/main.py - API Routes → API Handlers: routes to
README.md - API Handlers → Platform Services: delegates to
app/api/handlers/search_handler.py - Platform Services → Repositories: uses
app/main.py - Repositories → MongoDB: reads and writes
- API Handlers → Search Index: queries
app/api/handlers/search_handler.py - FastAPI Backend → MongoDB: initializes
app/main.py - User or Operator → Router Service: routes query
README.md - Router Service → Request Orchestrator: coordinates
agent-gateway/router/src/main.py - Request Orchestrator → Agent Registry Client: fetches cards
agent-gateway/router/src/services/router_orchestrator.py - Request Orchestrator → Routing Engine: selects agent
agent-gateway/router/src/services/router_orchestrator.py - Routing Engine → Agent Vector Store: searches
agent-gateway/router/src/core/routing_engine.py - Request Orchestrator → Agent Client: sends request
agent-gateway/router/src/services/router_orchestrator.py - Agent Client → Agent Services: forwards request
README.md - User or Operator → Translator Agent: chats with
- Translator Agent → Chat History Service: stores history
- Platform Services → Orchestration Service: triggers deployment
- Orchestration Service → Redis Command Stream: adds command
app/service/orchestration_service.py - Redis Command Stream → Kubernetes Build Worker: dispatches command
worker/k8s_build_worker.py - Kubernetes Build Worker → Kubernetes: builds and deploys
- Kubernetes Build Worker → Registry Manager: registers agent
- FastAPI Backend → Observability Services: offers monitoring
README.md - User or Operator → Auth Service: authenticates
README.md