Repository navigation
How do I install? #7153
|
The page doesn't give any instructions for installation, and none of the commands work. What do I do? |
Replies: 3 comments 4 replies
|
The instructions exist, but they're split across two files and the port numbers differ between them — which is probably why nothing you tried worked. Here's the whole picture in one place. Where the docs actually are
The port confusion is real and worth knowing before you start:
Docker (recommended)git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --buildThen wait until the containers are healthy — docker compose ps
docker compose logs -f odysseusOpen http://localhost:7011. Two things that trip people up here:
On Arch specifically, before any of the above: sudo systemctl enable --now docker
sudo usermod -aG docker "$USER" # then log out and back in
docker run --rm hello-world # sanity checkIf the GHCR image pull fails, Compose silently falls back to a local build — that's intentional, but it means Native install (Linux/macOS)git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000Requirements: Python 3.11+, and Apple Silicon (M-series) is its own path, because Docker on macOS can't reach the Metal GPU: ./start-macos.sh # launches on http://127.0.0.1:7860"None of the commands work" — the usual causes
If you paste the exact command you ran plus its full error output (and your OS), it's a one-line diagnosis — most of these have a single-line fix. |
|
Yes, you just use your regular Terminal (on Mac/Linux) or PowerShell (on Windows) — you don't need any special app to type commands into. The reason every command gives you an error right now is that tools like Here is the easiest way to install and run Odysseus without needing If you are on Windows
If you are on a Mac
If you still get an error, just tell me whether you're on Windows, Mac, or Linux and paste (or screenshot) the error message, and I'll walk you through it step by step! |
|
No worries at all — and thank you, genuinely. You stuck with it and actually tried every single thing I suggested: the Docker route, the native install, the terminal questions, and you came back each time with the exact error. That's what made it possible to narrow it down to the right script for your OS. Nothing you asked was a dumb question — telling me your OS and pasting the error message is more than most people do, and it's the whole reason we got there. Please don't apologise for not knowing GitHub. Everyone's first day with git, Docker and the terminal looks exactly like this, and you handled it faster than most. One small favour, if you don't mind: could you mark my reply as the answer? It's the "Mark as answer" option (the ✓) on my long Windows/macOS comment — sometimes it's inside the ⋯ menu. Two things happen if you do:
No pressure at all if you'd rather not, or if you can't find the button — I'm just glad it's running. Enjoy Odysseus, and if anything else breaks, reply here with the error and I'll take a look. |
Yes, you just use your regular Terminal (on Mac/Linux) or PowerShell (on Windows) — you don't need any special app to type commands into.
The reason every command gives you an error right now is that tools like
gitanddockeraren't pre-installed on a normal computer. Until you install a helper program first, the terminal simply doesn't recognize those words.Here is the easiest way to install and run Odysseus without needing
gitordocker:If you are on Windows
<> Codebutton near the top, an…