Project Structure

Click a file or folder to read its description. Folders expand and collapse on click. The tree opens with the main backend and frontend directories pre-expanded.

▼📂Luna/

▼📂backend/

🐍main.py

🐍config.py

▶📁middleware/

▼📂routers/

🐍admin.py

🐍channels.py

🐍chat.py

🐍luna.py

🐍system.py

🐍memory.py

🐍voice.py

🐍vision.py

🐍agent.py

🐍spotify.py

🐍calendar.py

🐍state.py

▼📂services/

🐍llm.py

🐍channel_bridge.py

🐍memory_manager.py

🐍personality.py

🐍fact_extractor.py

🐍tool_registry.py

🐍app_launcher.py

🐍web_tools.py

🐍scheduler.py

🐍vision.py

🐍spotify.py

🐍workspace.py

▶📁dashboard/

▶📁processes/

▶📁models/

▼📂frontend/

▼📂src/

📘App.tsx

📘main.tsx

🎨index.css

▶📁api/

▶📁components/

▶📁hooks/

▶📁store/

▶📁types/

📘vite.config.ts

📜tailwind.config.js

📋tsconfig.json

▶📁electron/

▶📁cli/

▶📁scripts/

▶📁docs-site/

▶📁data/

🔑.env

🔑.env.personal.example

🔑.env.business.example

⚙️compose.yml

⚙️compose.gpu.yml

⚙️compose.cloud.yml

⚙️compose.business.yml

📋package.json

🖼architecture.svg

← click a file to see its description

Tip: data/ is gitignored — never commit it. backend/ is Python,frontend/ is TypeScript.

Key entry points

When adding new functionality, these are the files to start with:

File	What to do here
`backend/main.py`	Mount new FastAPI routers.
`backend/config.py`	Add new .env settings as typed fields.
`backend/services/tool_registry.py`	Register new tools with a default permission mode.
`backend/services/llm.py`	Add a new LLM provider streaming generator.
`backend/processes/registry.py`	Register new background workers.
`frontend/src/App.tsx`	Add new top-level view modes.
`frontend/src/store/index.ts`	Add new global state slices and actions.
`electron/main.js`	Add native menus, IPC handlers, or OS integrations.
`cli/luna.mjs`	Add new developer CLI subcommands.

ℹ️

Where new code belongs

Routes go in backend/routers/. Business logic goes in backend/services/. Routers should be thin — validate input, call a service, return the result. Never put complex logic directly in a router.