# bikrammondal5/orbyteai architecture

> Architecture diagram of the GitHub repository bikrammondal5/orbyteai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bikrammondal5/orbyteai
- Repository: https://github.com/bikrammondal5/orbyteai

## Overview

OrbyteAI is an AI-agent orchestration platform with a Next.js product UI and API, MongoDB-backed user and agent management, and an Express runtime for agent chat and tools. The principal workflow is to configure an agent, persist it, select it in the sandbox, and send prompts through the backend chat pipeline for persona-aware responses with memory and optional tools. The README also advertises web search, file analysis, voice, image and video generation, and safety controls. Some backend modules were not sampled; those links are shown only where the README or SOURCE INDEX supports them.

Main entry points: [`personaforge-backend/routes/chat.js`](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/routes/chat.js) (Chat and Search Routes), [`app/api/agents/route.ts`](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/agents/route.ts) (Agent API), [`app/api/auth/signup/route.ts`](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/auth/signup/route.ts) (Auth Routes), [`personaforge-backend/services/ai.js`](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/ai.js) (Agent AI Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Product UI"]
  node_agent_ui["Agent Studio<br/>[page.tsx]"]
  node_sandbox["Agent Sandbox<br/>[page.tsx]"]
  node_dashboard["Agent Dashboard<br/>[page.tsx]"]
end

subgraph group_accounts["Identity and Data"]
  node_api_agents["Agent API<br/>[route.ts]"]
  node_forge_api["Forge API<br/>[route.ts]"]
  node_auth_ui["Auth Context<br/>[AuthContext.tsx]"]
  node_auth_api["Auth Routes<br/>[route.ts]"]
  node_auth_logic["Token and Password Auth<br/>[auth.ts]"]
  node_mongo["MongoDB Connection<br/>[mongodb.ts]"]
  node_agent_model[("Agent Records<br/>[Agent.ts]")]
  node_user_model[("User Records<br/>[User.ts]")]
  node_api_key_model[("API Key Records<br/>[ApiKey.ts]")]
end

subgraph group_runtime["Agent Runtime"]
  node_backend["Express Server<br/>[server.js]"]
  node_forge_route["Agent Forge Route<br/>[forge.js]"]
  node_chat_route["Chat and Search Routes<br/>[chat.js]"]
  node_memory[("Conversation Memory<br/>[memory.js]")]
  node_prompt["Persona Prompt Builder<br/>[promptBuilder.js]"]
  node_ai["Agent AI Runtime<br/>[ai.js]"]
  node_guardrails["Safety Guardrails<br/>[guardrails.js]"]
end

subgraph group_capabilities["Tools and Generation"]
  node_mcp["MCP Tool Bridge<br/>[mcpBridge.js]"]
  node_file_tool["File Intelligence<br/>[readFileTool.js]"]
  node_search["Web Search<br/>[searchAgent.js]"]
  node_toolsets["External Toolsets"]
  node_image_api["Image Generation<br/>[route.ts]"]
  node_video_api["Video Generation<br/>[route.ts]"]
end

node_user(("Developer"))

node_user -->|"configures agent"| node_agent_ui
node_agent_ui -.->|"requests generation"| node_forge_api
node_user -->|"manages agents"| node_dashboard
node_dashboard -.->|"loads agents"| node_api_agents
node_api_agents -->|"connects database"| node_mongo
node_api_agents -->|"creates and reads"| node_agent_model
node_api_agents -->|"checks user"| node_user_model
node_user -->|"tests agent"| node_sandbox
node_sandbox -.->|"sends prompts"| node_backend
node_backend -->|"routes /v1"| node_chat_route
node_backend -->|"routes /forge"| node_forge_route
node_chat_route -->|"loads and saves history"| node_memory
node_chat_route -->|"builds persona prompt"| node_prompt
node_chat_route -->|"requests response"| node_ai
node_chat_route -->|"reads attachments"| node_file_tool
node_chat_route -->|"dispatches search"| node_search
node_ai -->|"loads MCP tools"| node_mcp
node_ai -->|"loads integrations"| node_toolsets
node_ai -->|"uses file tool"| node_file_tool
node_chat_route -.->|"applies safeguards"| node_guardrails
node_user -->|"signs in"| node_auth_ui
node_auth_ui -->|"signs up"| node_auth_api
node_auth_api -->|"hashes credentials"| node_auth_logic
node_auth_api -->|"connects database"| node_mongo
node_auth_api -->|"stores user"| node_user_model
node_user -.->|"manages API keys"| node_api_key_model
node_user -.->|"requests images"| node_image_api
node_user -.->|"requests videos"| node_video_api

click node_agent_ui "https://github.com/bikrammondal5/orbyteai/blob/main/app/create-agent/page.tsx"
click node_sandbox "https://github.com/bikrammondal5/orbyteai/blob/main/app/sandbox/page.tsx"
click node_dashboard "https://github.com/bikrammondal5/orbyteai/blob/main/app/dashboard/page.tsx"
click node_api_agents "https://github.com/bikrammondal5/orbyteai/blob/main/app/api/agents/route.ts"
click node_forge_api "https://github.com/bikrammondal5/orbyteai/blob/main/app/api/forge-agent/route.ts"
click node_auth_ui "https://github.com/bikrammondal5/orbyteai/blob/main/contexts/AuthContext.tsx"
click node_auth_api "https://github.com/bikrammondal5/orbyteai/blob/main/app/api/auth/signup/route.ts"
click node_auth_logic "https://github.com/bikrammondal5/orbyteai/blob/main/lib/auth.ts"
click node_mongo "https://github.com/bikrammondal5/orbyteai/blob/main/lib/mongodb.ts"
click node_agent_model "https://github.com/bikrammondal5/orbyteai/blob/main/models/Agent.ts"
click node_user_model "https://github.com/bikrammondal5/orbyteai/blob/main/models/User.ts"
click node_api_key_model "https://github.com/bikrammondal5/orbyteai/blob/main/models/ApiKey.ts"
click node_backend "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/server.js"
click node_forge_route "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/routes/forge.js"
click node_chat_route "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/routes/chat.js"
click node_memory "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/memory.js"
click node_prompt "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/promptBuilder.js"
click node_ai "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/ai.js"
click node_guardrails "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/guardrails.js"
click node_mcp "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/mcpBridge.js"
click node_file_tool "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/readFileTool.js"
click node_search "https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/searchAgent.js"
click node_toolsets "https://github.com/bikrammondal5/orbyteai/tree/main/personaforge-backend/services"
click node_image_api "https://github.com/bikrammondal5/orbyteai/blob/main/app/api/image-generation/route.ts"
click node_video_api "https://github.com/bikrammondal5/orbyteai/blob/main/app/api/video-generation/route.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agent_ui,node_sandbox,node_dashboard toneBlue
class node_api_agents,node_forge_api,node_auth_ui,node_auth_api,node_auth_logic,node_mongo,node_agent_model,node_user_model,node_api_key_model toneAmber
class node_backend,node_forge_route,node_chat_route,node_memory,node_prompt,node_ai,node_guardrails toneMint
class node_mcp,node_file_tool,node_search,node_toolsets,node_image_api,node_video_api toneRose
class node_user toneIndigo
```

## Components

### Product UI

- [Agent Studio](https://github.com/bikrammondal5/orbyteai/blob/main/app/create-agent/page.tsx): `app/create-agent/page.tsx`
- [Agent Sandbox](https://github.com/bikrammondal5/orbyteai/blob/main/app/sandbox/page.tsx): `app/sandbox/page.tsx`
- [Agent Dashboard](https://github.com/bikrammondal5/orbyteai/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`

### Identity and Data

- [Agent API](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/agents/route.ts): `app/api/agents/route.ts`
- [Forge API](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/forge-agent/route.ts): `app/api/forge-agent/route.ts`
- [Auth Context](https://github.com/bikrammondal5/orbyteai/blob/main/contexts/AuthContext.tsx): `contexts/AuthContext.tsx`
- [Auth Routes](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/auth/signup/route.ts): `app/api/auth/signup/route.ts`
- [Token and Password Auth](https://github.com/bikrammondal5/orbyteai/blob/main/lib/auth.ts): `lib/auth.ts`
- [MongoDB Connection](https://github.com/bikrammondal5/orbyteai/blob/main/lib/mongodb.ts): `lib/mongodb.ts`
- [Agent Records](https://github.com/bikrammondal5/orbyteai/blob/main/models/Agent.ts): `models/Agent.ts`
- [User Records](https://github.com/bikrammondal5/orbyteai/blob/main/models/User.ts): `models/User.ts`
- [API Key Records](https://github.com/bikrammondal5/orbyteai/blob/main/models/ApiKey.ts): `models/ApiKey.ts`

### Agent Runtime

- [Express Server](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/server.js): `personaforge-backend/server.js`
- [Agent Forge Route](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/routes/forge.js): `personaforge-backend/routes/forge.js`
- [Chat and Search Routes](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/routes/chat.js): `personaforge-backend/routes/chat.js`
- [Conversation Memory](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/memory.js): `personaforge-backend/services/memory.js`
- [Persona Prompt Builder](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/promptBuilder.js): `personaforge-backend/services/promptBuilder.js`
- [Agent AI Runtime](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/ai.js): `personaforge-backend/services/ai.js`
- [Safety Guardrails](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/guardrails.js): `personaforge-backend/services/guardrails.js`

### Tools and Generation

- [MCP Tool Bridge](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/mcpBridge.js): `personaforge-backend/services/mcpBridge.js`
- [File Intelligence](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/readFileTool.js): `personaforge-backend/services/readFileTool.js`
- [Web Search](https://github.com/bikrammondal5/orbyteai/blob/main/personaforge-backend/services/searchAgent.js): `personaforge-backend/services/searchAgent.js`
- [External Toolsets](https://github.com/bikrammondal5/orbyteai/tree/main/personaforge-backend/services): `personaforge-backend/services`
- [Image Generation](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/image-generation/route.ts): `app/api/image-generation/route.ts`
- [Video Generation](https://github.com/bikrammondal5/orbyteai/blob/main/app/api/video-generation/route.ts): `app/api/video-generation/route.ts`

### Other components

- **Developer**

## Connections

- Developer → Agent Studio: configures agent
- Agent Studio → Forge API: requests generation
- Developer → Agent Dashboard: manages agents
- Agent Dashboard → Agent API: loads agents
- Agent API → MongoDB Connection: connects database (evidence: `app/api/agents/route.ts`)
- Agent API → Agent Records: creates and reads (evidence: `app/api/agents/route.ts`)
- Agent API → User Records: checks user (evidence: `app/api/agents/route.ts`)
- Developer → Agent Sandbox: tests agent
- Agent Sandbox → Express Server: sends prompts
- Express Server → Chat and Search Routes: routes /v1 (evidence: `personaforge-backend/server.js`)
- Express Server → Agent Forge Route: routes /forge (evidence: `personaforge-backend/server.js`)
- Chat and Search Routes → Conversation Memory: loads and saves history (evidence: `personaforge-backend/routes/chat.js`)
- Chat and Search Routes → Persona Prompt Builder: builds persona prompt (evidence: `personaforge-backend/routes/chat.js`)
- Chat and Search Routes → Agent AI Runtime: requests response (evidence: `personaforge-backend/routes/chat.js`)
- Chat and Search Routes → File Intelligence: reads attachments (evidence: `personaforge-backend/routes/chat.js`)
- Chat and Search Routes → Web Search: dispatches search (evidence: `personaforge-backend/routes/chat.js`)
- Agent AI Runtime → MCP Tool Bridge: loads MCP tools (evidence: `personaforge-backend/services/ai.js`)
- Agent AI Runtime → External Toolsets: loads integrations (evidence: `personaforge-backend/services/ai.js`)
- Agent AI Runtime → File Intelligence: uses file tool (evidence: `personaforge-backend/services/ai.js`)
- Chat and Search Routes → Safety Guardrails: applies safeguards
- Developer → Auth Context: signs in
- Auth Context → Auth Routes: signs up (evidence: `contexts/AuthContext.tsx`)
- Auth Routes → Token and Password Auth: hashes credentials (evidence: `app/api/auth/signup/route.ts`)
- Auth Routes → MongoDB Connection: connects database (evidence: `app/api/auth/signup/route.ts`)
- Auth Routes → User Records: stores user (evidence: `app/api/auth/signup/route.ts`)
- Developer → API Key Records: manages API keys
- Developer → Image Generation: requests images
- Developer → Video Generation: requests videos
