How cyrivea/neyria works
Neyria is a platform-hosted AI creation workspace. Users enter through the Vue workstation to chat with a streaming assistant, use creative capabilities, manage project knowledge, and edit or run workflows; the FastAPI backend coordinates these requests while keeping model credentials server-side. Supporting product branches include authentication, billing, durable jobs, and project assets. The graph combines documented product behavior with the sampled source and SOURCE INDEX; some subsystem connections are documented rather than directly shown in excerpts.
Main entry points: main.py FastAPI API · chat_orchestrator.py ReAct orchestrator · service.py Project RAG · assistant.py Assistant endpoint
Components 28
Workspace UI
- Vue workstation
frontend/src/views/workstation/Workstation.vue - Assistant panel
frontend/src/components/assistant/AssistantPanel.vue - Chat client
frontend/src/composables/useAgentChat.ts - Workflow canvas
frontend/src/components/workflow/WorkflowCanvas.vue
Assistant
- Assistant endpoint
backend/routers/assistant.py - ReAct orchestrator
backend/services/chat/chat_orchestrator.py - Context builder
backend/services/chat/context_builder.py - Intent classifier
backend/services/chat/intent_classifier.py - Tool executor
backend/services/chat/tool_executor.py - Chat history
backend/repositories/chat_repo.py
Creation and workflows
- Capability endpoint
backend/routers/capabilities.py - Capability runtime
backend/services/capabilities/runtime.py - Model providers
backend/services/capabilities - Workflow endpoint
backend/routers/workflows.py - Workflow runner
backend/services/workflow_service.py
Knowledge and jobs
- Projects and assets
backend/services/project_service.py - Project RAG
backend/services/rag/service.py - Job service
backend/services/job_service.py - Job worker
backend/workers/job_worker.py - Job dispatcher
backend/workers/dispatcher.py - Jobs and documents
backend/repositories/job_repo.py
Platform services
- FastAPI API
backend/main.py - Authentication
backend/routers/auth.py - Auth service
backend/services/auth_service.py - Billing endpoint
backend/routers/billing.py - Billing ledger
backend/services/billing_service.py - Usage ledger
backend/repositories/billing_repo.py
Other components
- User
Connections 35
- User → Vue workstation: uses
README.md - Vue workstation → Assistant panel: opens
README.md - Assistant panel → Chat client: sends messages
frontend/src/composables/useAgentChat.ts - Chat client → Assistant endpoint: streams requests
README.md - FastAPI API → Assistant endpoint: routes to
backend/main.py - Assistant endpoint → ReAct orchestrator: invokes
backend/routers/assistant.py - ReAct orchestrator → Context builder: builds context
backend/services/chat/chat_orchestrator.py - ReAct orchestrator → Intent classifier: classifies intent
backend/services/chat/chat_orchestrator.py - ReAct orchestrator → Tool executor: executes tools
backend/services/chat/chat_orchestrator.py - ReAct orchestrator → Chat history: persists messages
backend/services/chat/chat_orchestrator.py - Context builder → Project RAG: retrieves knowledge
backend/services/chat/context_builder.py - Tool executor → Capability runtime: runs capabilities
README.md - User → Workflow canvas: edits workflow
README.md - Workflow canvas → Workflow endpoint: runs workflow
README.md - FastAPI API → Workflow endpoint: routes to
backend/main.py - Workflow endpoint → Workflow runner: invokes
- Workflow runner → Capability runtime: runs nodes
README.md - User → Capability endpoint: uses tools
README.md - FastAPI API → Capability endpoint: routes to
backend/main.py - Capability runtime → Model providers: calls providers
README.md - User → Project RAG: asks document questions
README.md - Project RAG → Job service: queues document jobs
- Job worker → Jobs and documents: claims jobs
backend/workers/job_worker.py - Job worker → Job dispatcher: dispatches jobs
backend/workers/job_worker.py - Job dispatcher → Workflow runner: handles workflow runs
backend/workers/dispatcher.py - Job service → Jobs and documents: persists jobs
- User → Authentication: authenticates
backend/routers/auth.py - FastAPI API → Authentication: routes to
backend/main.py - Authentication → Auth service: calls
backend/routers/auth.py - User → Billing endpoint: manages billing
README.md - FastAPI API → Billing endpoint: routes to
backend/main.py - Billing endpoint → Billing ledger: invokes
- Billing ledger → Usage ledger: records usage
backend/services/billing_service.py - User → Projects and assets: manages projects
README.md - Projects and assets → Project RAG: scopes project knowledge