Ɗiogenēs

A self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows.

Diogenes Native Setup · Services · Native Engines · Hermes · Upstream Docker · Setup Guide · Contributing

---

Diogenes native workstation setup

Ɗiogenēs is a dev-based extension that keeps Odysseus routes and data contracts intact while adding a native, admin-only workstation control plane:

• Docker, Bun/NPX, native, tmux, and Hermes runtimes in the Services window;
• a standalone Sandwich Bun compatibility layer—system Node, npm, pnpm, and yarn are not required;
• separate Colibri GLM, Colibri Hy3, and PrismML native model engines;
• guarded vLLM installation into this checkout's .venv, including the current CUDA 13 nightly lane;
• isolated high-throughput model downloads and confirmation-gated Git, build, configuration, lifecycle, and update jobs;
• an optional, canonical oh-my-pi runtime with Persephone providing the persistent local gateway, channels, schedules, and RPC supervision it omits;
• optional Hermes Librarian/Retrieval orchestration without merging the Odysseus and Hermes agents or their MCP registries.

From a reviewed dev checkout:

./uvsetup.sh
./startwithuv.sh

uvsetup.sh creates the Python 3.13.12 inner virtual environment, installs requirements.txt, and runs the native setup. startwithuv.sh starts only the web application on 0.0.0.0:7000. In-place update and runtime-state instructions are in docs/DIOGENES_DEPLOYMENT.md.

After the optional OMP, Persephone, and local backend dependencies are installed, ./ompsettings.sh can apply the workstation's optimized OMP preference baseline once. It is deliberately never run by Integrate, preserves MCP/model/auth/session configuration, and asks for confirmation before writing; open omp, then run /settings to review the result.

Native services without system Node

Diogenes integrates system services through a deliberately minimal control plane built around native Bun. Sandwich provides compatible node, npm, npx, and pnpm command surfaces without requiring system Node; Diogenes itself adds no telemetry and keeps the JavaScript ecosystem as low-friction as practical. The Services window discovers and manages Docker Compose projects, interactive tmux services, Git checkouts, configuration files, updates, and native integration jobs without conflating their runtimes.

Cookbook dependencies

The existing Cookbook dependency workflow remains intact and gains clearly separated native extras: Sandwich, independently built Colibri GLM and Colibri Hy3 engines, PrismML, and a lightweight Hermes installation. Python dependencies—including the guarded CUDA 13 vLLM nightly lane—stay inside the Diogenes .venv; native engines and service projects retain their own source, build, update, and configuration boundaries.

Native model engines

The Launch view preserves Odysseus' editable commands, saved configurations, and advanced runtime controls while adding first-class Colibri GLM, Colibri Hy3, and PrismML engines. Hardware-aware profiles expose the supported Colibri flags directly, including tuned RTX 5090 starting points for serving GLM 5.2 and Hy3 locally without hiding the final launch command.

Hermes knowledge orchestration

The optional Hermes integration extends the lightweight FastEmbed and Chroma retrieval pattern shipped with Odysseus across Hermes skills, sessions, Context Mode data, and project knowledge. A persistent watcher keeps those sources indexed as they change, so specialized skill libraries can remain searchable without bloating the always-active Hermes skill set.

The in-house Librarian MCP can delegate a focused lookup to a second model process, search disk-backed context, and return the relevant material to the calling model. Retrieval, Codebase Memory MCP, Context Mode's native Hermes integration, and the context-saving integrations are wired alongside Hermes Workspace orchestration, allowing agents to work from task sheets and pursue defined background goals without merging the Odysseus and Hermes agents or their MCP registries.

Upstream Docker Quick Start

dev is the default branch and gets the newest changes first. Use main if you want the more curated branch.

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build

Open http://localhost:7000 when the containers are healthy. The first admin password is printed in docker compose logs odysseus.

Native installs, GPU notes, Windows/macOS instructions, HTTPS, and configuration live in the setup guide.

Features

• Chat + Agents — local/API models, tools, MCP, files, shell, skills, and memory.
• Cookbook — hardware-aware model recommendations, downloads, and serving.
• Deep Research — multi-step web research with source reading and report generation.
• Compare — blind side-by-side model testing and synthesis.
• Documents — writing-first editor with AI edits, suggestions, Markdown, HTML, CSV, and syntax highlighting.
• Email — IMAP/SMTP inbox with triage, tags, summaries, reminders, and reply drafts.
• Notes, Tasks + Calendar — reminders, todos, scheduled agent tasks, and CalDAV sync.
• Extras — gallery/image editor, themes, uploads, web search, presets, sessions, and 2FA.

Demo

A full hover-to-play tour lives on the landing page: docs/index.html.

Contributing

Help is welcome. The best entry points are fresh-install testing, provider setup bugs, mobile/editor polish, docs, and small focused refactors. See CONTRIBUTING.md.

Security

Odysseus is a self-hosted workspace with powerful local tools. Keep auth enabled, keep private data out of Git, and do not expose raw model/service ports publicly. Deployment details are in the setup guide.

Visit my docs/blog! ReadThe docs.shel.sh

License

AGPL-3.0-or-later -- see LICENSE and ACKNOWLEDGMENTS.md.