Project Structure

Interactive file explorer for the Luna monorepo. Click any file to see what it does.

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/
▼📂server/
🐍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/
▼📂interfaces/web/
▼📂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. server/ is Python,interfaces/web/ is TypeScript.

Key entry points

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

FileWhat to do here
server/main.pyMount new FastAPI routers.
server/config.pyAdd new .env settings as typed fields.
server/services/tool_registry.pyRegister new tools with a default permission mode.
server/services/llm/Add a new LLM provider streaming generator.
server/processes/registry.pyRegister new background workers.
interfaces/web/src/App.tsxAdd new top-level view modes.
interfaces/web/src/store/index.tsAdd new global state slices and actions.
electron/main.jsAdd native menus, IPC handlers, or OS integrations.
interfaces/cli/luna.mjsAdd new developer CLI subcommands.
ℹ️
Where new code belongs

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