# rudra00434/codenova.devs architecture

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

- Interactive diagram: https://gitdiagram.com/rudra00434/codenova.devs
- Repository: https://github.com/rudra00434/codenova.devs

## Overview

CodeNova is a Streamlit developer suite backed by a FastAPI service. A user works in the UI, which sends API requests to backend routes; those routes invoke shared utilities for AI, sandboxing, monitoring, exports, and persistence. The README documents the major features and frontend/backend split; excerpts show representative route-to-utility calls and SQLite access. Some feature internals were not sampled, so those branches are shown at the documented route level.

Main entry points: [`api.py`](https://github.com/rudra00434/codenova.devs/blob/main/api.py) (FastAPI service), [`codenova.db`](https://github.com/rudra00434/codenova.devs/blob/main/codenova.db) (SQLite data), [`main.py`](https://github.com/rudra00434/codenova.devs/blob/main/main.py) (Streamlit app), [`utils.py`](https://github.com/rudra00434/codenova.devs/blob/main/utils.py) (AI chains)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_ui["Streamlit app<br/>[main.py]"]
end

subgraph group_backend["Backend routes"]
  node_api["FastAPI service<br/>[api.py]"]
  node_sessions["Sessions and export<br/>[api.py]"]
  node_chat["Chat and voice<br/>[api.py]"]
  node_code_tools["Code tools<br/>[api.py]"]
  node_sandbox["Code sandbox<br/>[api.py]"]
  node_api_suite["API suite<br/>[api.py]"]
  node_generators["Generators<br/>[api.py]"]
  node_snippets["Snippet library<br/>[api.py]"]
end

subgraph group_services["Shared services"]
  node_llm["AI chains<br/>[utils.py]"]
  node_sandbox_runtime["Sandbox runtime<br/>[utils.py]"]
  node_monitoring["API monitoring<br/>[utils.py]"]
  node_exports["PDF export<br/>[utils.py]"]
end

subgraph group_state["Persistence"]
  node_sqlite[("SQLite data<br/>[codenova.db]")]
end

node_user(("Developer"))
node_groq["Groq models"]
node_external_api["External APIs"]

node_user -->|"uses"| node_ui
node_ui -->|"requests"| node_api
node_api -->|"routes"| node_sessions
node_api -->|"routes"| node_chat
node_api -->|"routes"| node_code_tools
node_api -->|"routes"| node_sandbox
node_api -->|"routes"| node_api_suite
node_api -->|"routes"| node_generators
node_api -->|"routes"| node_snippets
node_api -->|"invokes"| node_llm
node_api -->|"invokes"| node_sandbox_runtime
node_api -->|"invokes"| node_monitoring
node_api -->|"invokes"| node_exports
node_sessions -->|"reads and writes"| node_sqlite
node_snippets -->|"stores snippets"| node_sqlite
node_api_suite -->|"sends requests"| node_external_api
node_llm -->|"calls models"| node_groq
node_chat -->|"stores history"| node_sqlite

click node_ui "https://github.com/rudra00434/codenova.devs/blob/main/main.py"
click node_api "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_sessions "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_chat "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_code_tools "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_sandbox "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_api_suite "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_generators "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_snippets "https://github.com/rudra00434/codenova.devs/blob/main/api.py"
click node_llm "https://github.com/rudra00434/codenova.devs/blob/main/utils.py"
click node_sandbox_runtime "https://github.com/rudra00434/codenova.devs/blob/main/utils.py"
click node_monitoring "https://github.com/rudra00434/codenova.devs/blob/main/utils.py"
click node_exports "https://github.com/rudra00434/codenova.devs/blob/main/utils.py"
click node_sqlite "https://github.com/rudra00434/codenova.devs/blob/main/codenova.db"

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_ui toneBlue
class node_api,node_sessions,node_chat,node_code_tools,node_sandbox,node_api_suite,node_generators,node_snippets toneAmber
class node_llm,node_sandbox_runtime,node_monitoring,node_exports,node_external_api toneMint
class node_sqlite toneRose
class node_user,node_groq toneIndigo
```

## Components

### User interface

- [Streamlit app](https://github.com/rudra00434/codenova.devs/blob/main/main.py): `main.py`

### Backend routes

- [FastAPI service](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Sessions and export](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Chat and voice](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Code tools](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Code sandbox](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [API suite](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Generators](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`
- [Snippet library](https://github.com/rudra00434/codenova.devs/blob/main/api.py): `api.py`

### Shared services

- [AI chains](https://github.com/rudra00434/codenova.devs/blob/main/utils.py): `utils.py`
- [Sandbox runtime](https://github.com/rudra00434/codenova.devs/blob/main/utils.py): `utils.py`
- [API monitoring](https://github.com/rudra00434/codenova.devs/blob/main/utils.py): `utils.py`
- [PDF export](https://github.com/rudra00434/codenova.devs/blob/main/utils.py): `utils.py`

### Persistence

- [SQLite data](https://github.com/rudra00434/codenova.devs/blob/main/codenova.db): `codenova.db`

### Other components

- **Developer**
- **Groq models**
- **External APIs**

## Connections

- Developer → Streamlit app: uses (evidence: `README.md`)
- Streamlit app → FastAPI service: requests (evidence: `README.md`)
- FastAPI service → Sessions and export: routes (evidence: `README.md`)
- FastAPI service → Chat and voice: routes (evidence: `README.md`)
- FastAPI service → Code tools: routes (evidence: `README.md`)
- FastAPI service → Code sandbox: routes (evidence: `README.md`)
- FastAPI service → API suite: routes (evidence: `README.md`)
- FastAPI service → Generators: routes (evidence: `README.md`)
- FastAPI service → Snippet library: routes (evidence: `README.md`)
- FastAPI service → AI chains: invokes (evidence: `api.py`)
- FastAPI service → Sandbox runtime: invokes (evidence: `api.py`)
- FastAPI service → API monitoring: invokes (evidence: `api.py`)
- FastAPI service → PDF export: invokes (evidence: `api.py`)
- Sessions and export → SQLite data: reads and writes (evidence: `api.py`)
- Snippet library → SQLite data: stores snippets (evidence: `README.md`)
- API suite → External APIs: sends requests (evidence: `api.py`)
- AI chains → Groq models: calls models (evidence: `README.md`)
- Chat and voice → SQLite data: stores history (evidence: `README.md`)
