A self-hosted AI workspace — chat, agents, research, documents,
email, notes, calendar, and local model workflows.
A personal fork of Odysseus,
rebuilt in the PNSE corporate identity.
Quick Start · What's different · Identity · Setup Guide · Fork notice
git clone git@github.com:P-hinn/odysseus.git ithaka
cd ithaka
cp .env.example .env
docker compose up -d --buildOpen http://localhost:7000 once 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.
| Identity | PNSE corporate identity throughout — pn-paper (light) is the default theme, pn-ink (dark) ships alongside it. Space Grotesk and Manrope replace Fira Code as the default UI type. New wordmark, PWA icons, and favicon. |
| No deployment | The upstream GitHub Pages deploy and the GHCR image publish are removed. CI builds, lints, tests, and scans — it never deploys or publishes anything. A regression test guards that. |
| Internals unchanged | Environment variables stay ODYSSEUS_*, vector collections stay odysseus_*, and the localStorage keys are untouched, so git merge upstream/dev stays cheap. |
This repository is a GitHub fork of odysseus-dev/odysseus, so it keeps its
original name there. main carries Ithaka; dev stays a clean mirror of
upstream. The real upstream is wired up as the upstream remote:
git fetch upstream && git merge upstream/devThe palette and type come straight from philippniestroj.com.
| Token | Hex | Role |
|---|---|---|
--ink |
#171714 |
Text on paper, background in pn-ink |
--paper |
#f1efe8 |
Page ground, text in pn-ink |
--acid |
#d8ff55 |
Highlight — selection, toggles, the mark on dark |
--blue |
#5c76ff |
Accent — links, send button, focus |
Type: Space Grotesk for display, Manrope for UI text, tight tracking,
square corners. Both faces are self-hosted under static/fonts/.
- 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.
Ithaka 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.
- Keep
AUTH_ENABLED=truefor any network-accessible deployment. - Keep
LOCALHOST_BYPASS=falseoutside local development.
Deployment details are in the setup guide.
AGPL-3.0-or-later — see LICENSE, NOTICE.md, and ACKNOWLEDGMENTS.md.
Because this is a modified version of an AGPL-3.0 program: if you run it on a network-accessible server, you must offer its users the corresponding source of this version.