Is odysseus still maintained?

Yes, active. Last change today.

Can I trust odysseus?

Some track record. 95k stars, 5 months old, by an organization. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install odysseus on macOS (odysseus-dev/odysseus) · gitmanual

How to install on macOS

odysseus-dev/odysseus

Self-hosted AI workspace.

Node.jsPythonFastAPI

Difficulty: Involved
Time: 30 min or more
Stars: ★ 95,409
Activity: Updated this month

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Still maintained?: Yes, activeLast change today.
Can I trust it?: Some track record95k stars, 5 months old, by an organization. Get it from the official repo and read what it installs.

Saved setup from 9 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗odysseus-dev.github.ioThe project's own site.

Heads-upBuilding it yourself? It also needs PostgreSQL, Vector DB and 3 settings in .env.

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d --build

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 22.23.4runtime
1×Python 3.11runtime
1×Docker tool
1×npm package manager
1×pip package manager
1×PostgreSQL service
1×Vector DB service

3× settings in .env

LLM_HOST
SEARXNG_INSTANCE
ODYSSEUS_EDITOR_DRAFT_MAX_BYTES

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/odysseus-dev/odysseus/badge.svg)](https://gitmanual.com/odysseus-dev/odysseus)

Good to know

Dockerfile available (base image: python:3.14.9-slim).
Nested projects: frontend/src/package.json, static/js/package.json

Details

License: AGPL-3.0
Open issues: 1,494
Branch: dev

package.json scripts (8)

test:photo-editorplaywright test --config tests/e2e/playwright.config.js
test:photo-editor:installplaywright install chromium firefox webkit
test:photo-editor:firefoxPHOTO_EDITOR_E2E_BROWSER=firefox playwright test --config tests/e2e/playwright.config.js
test:photo-editor:webkitPHOTO_EDITOR_E2E_BROWSER=webkit playwright test --config tests/e2e/playwright.config.js
test:ios-layoutplaywright test --config tests/e2e/ios-layout.config.cjs
test:ios-layout:chromiumODYSSEUS_LAYOUT_BROWSER=chromium playwright test --config tests/e2e/ios-layout.config.cjs
test:ios-layout:webkitODYSSEUS_LAYOUT_BROWSER=webkit playwright test --config tests/e2e/ios-layout.config.cjs
test:ios-layout:installplaywright install chromium webkit

Files we read (16)

.env.example

.github/workflows/ci.yml

.github/workflows/codeql.yml

.github/workflows/container-scan.yml

.github/workflows/container-trivy.yml

.github/workflows/issue-description-check.yml

.github/workflows/pr-description-check.yml

CONTRIBUTING.md

Dockerfile

README.md

docker-compose.yml

package.json

pyproject.toml

requirements-dev.txt

requirements.txt

setup.py

3,051 files in the repo