Brooks Computing Systems - Jacksonville
Visit Brooks Computing Systems
Mainframes, Desktops & Web Sites
Okay, here's a breakdown of the Odysseus dev workspace based on the provided information:
Okay, here's a breakdown of the Odysseus dev workspace based on the provided information:
**Odysseus Dev Workspace Overview**
This workspace contains a full-stack AI application with the following structure:
**Stack**
- **Backend:** Python 3.11+ / FastAPI + Uvicorn (for the API server)
- **Frontend:** Vanilla JS SPA served as ES modules (no separate build step)
- **Database:** SQLite via SQLAlchemy
- **Vector Store:** ChromaDB (can be run in Docker or standalone)
- **Search:** SearXNG (self-hosted web search)
- **Notifications:** ntfy
**Key Directories & Files**
- **`app.py` / `launcher.py`:** Entry points for the backend application.
- **`core/`:** Contains core backend logic like authentication, database interactions, middleware, and constants.
- **`src/`:** Houses the core LLM logic, agent loop, tools, chat processing, RAG (Retrieval-Augmented Generation), MCP manager, and embedding functions.
- **`routes/`:** Contains individual HTTP route modules (e.g., chat, memory, docs, email, calendar, cookbook, dev features).
- **`services/`:** Includes modules for specific functionalities like document handling, search, memory management, TTS (Text-to-Speech), STT (Speech-to-Text), YouTube integration, and hwfit (likely health/wellness).
- **`static/`:** Contains the `index.html` and modular JavaScript files for the frontend application.
- **`companion/`:** Directory for the AI companion module.
- **`chroma/`:** Directory for ChromaDB integration code/configuration.
- **`mcp_servers/`:** Contains the Model Context Protocol server implementations.
- **`integrations/`:** Houses third-party integration code (e.g., Auth0, Slack).
- **`config/`:** Contains configuration templates (e.g., SearXNG settings).
- **`tests/`:** Contains pytest unit/integration tests, organized by area markers (`-m` flag).
- **`data/`:** Directory for runtime data (ignored by Git) like databases, uploads, memory stores, and settings (not to be confused with `config/`).
- **`docs/`:** Likely contains project documentation (e.g., `setup.md`).
- **`.env.example`:** Example file for deployment environment variables (e.g., LLM endpoints, auth secrets, ports).
- **`pyproject.toml`, `requirements.txt`:** Python dependency files.
- **`package.json`:** Front
Quality, Reliability & Service Consultancy for Mainframes, Desktops & Web Sites