Venice keysVeniceLearn · GuidesOpen Venice ↗
Guide · AI Agents

Run PewDiePie's Odysseus AI workspace privately with Venice

Odysseus is a self-hosted, highly configurable AI workspace, but it is only as private as the model provider behind it. This guide shows how to install Odysseus and wire it to Venice so your prompts and chats are not stored, then how to set up models, skills, and defaults to balance cost, speed, and privacy.

Watch the full walkthrough
What you'll learn
  • Why a "privacy first" local app still leaks your data if you point it at OpenAI, Anthropic, or Google
  • How to install Odysseus on Windows, macOS, or Linux, and when to run it in Docker
  • How to connect Venice as your provider with a single API key and reach all available models
  • How to mix Venice API models with local models served through the cookbook
  • How to choose default, fallback, utility, research, and teacher models to cut cost without losing capability

What Odysseus is and the privacy catch

Odysseus is an AI workspace from PewDiePie that runs locally on your computer and is fully self-hosted. It is a different style of agent than tools like OpenClaw or Hermes, and it is marketed as privacy first.

The marketing only holds if the model behind it is private. Odysseus itself runs on your machine, but the moment you point it at OpenAI, Anthropic, Google, or DeepSeek, your prompts and chats flow to those providers and get stored. That is why this setup uses Venice as the provider: Venice does not store your chat content, so the local app and the model both respect your privacy.

The project is open source with a large following on GitHub. Before installing, you can read the repo's README to confirm the feature list matches what is advertised.

Installing Odysseus and the Docker decision

Start on the Odysseus site by clicking the Get Started link and copying the install command. Open a terminal (PowerShell on Windows) and paste it. That command clones the GitHub repo to your computer and changes into the new directory, but it does not start the app yet.

To launch it, go to the Quick Start section of the README and find your operating system: native Linux, macOS, Apple Silicon, or Windows. Copy everything listed after the cd Odysseus step for your platform and run it. On Apple Silicon, that is a single launch script. The installer pulls down Python and anything else it needs, then asks you to set a username and password before loading Odysseus at a local URL in your browser.

Decide where it runs before you commit. Installing directly on the machine is fine for a work computer with no sensitive data. On a personal machine, run it in Docker instead. Docker puts Odysseus in its own container so the agent cannot reach out and accidentally damage anything on your system, the same precaution you would take with any autonomous agent.

Connecting Venice as your provider

Once you log in, the theme customizer lets you pick a color scheme and fine-tune the look. It is a small thing, but it signals how much of Odysseus you can control.

To configure models, type /setup. You can click a listed provider to paste its key, or skip the wizard and go straight into Settings. Under Add Models, choose API and enter the Venice base URL:

https://api.venice.ai/api/v1

Open the Venice API dashboard, generate a new key (name it something like "Odysseus" and optionally set an expiration or spend limit), copy it, and paste it back into Odysseus. Click Test. It should report online and find the full set of available models. Click Add, and every Venice model is now enabled through one key. On the Venice API settings page you can browse those models and filter by agentic capability (function calling, reasoning, code, vision) to find ones suited to agent work.

Mixing Venice API models with local models

If your machine is capable, you can run local models alongside the Venice API. Open the Cookbook tab, which checks your hardware and shows which local models will run well. On Apple Silicon, for example, it flags models that fit the GPU. Click a model to download and serve it, then use the Serve tab to launch it (Gemma is one example). Models that do not show the Venice label are running locally.

The Dependencies tab in this area is easy to overlook. Image features need it. Install RMBG for AI background removal, AI denoise and upscale for image cleanup, Playwright for browser automation, and diffusers for image generation and editing. On macOS you may need Tmux first. If a feature fails later, this tab is usually why.

Back in Settings you will now see both your local model and the Venice API models listed together, all reachable from one workspace.

Choosing default models and using the rest of Odysseus

Open AI Defaults to assign a model to each role, which is where the cost savings come from. The video sets Minimax M3 as the default chat model, citing roughly $1.20 output per million tokens against about $30 for Claude Opus, and adds Kimi K2.6 as a fallback. The utility model handles quick, low-stakes calls, so point it at a local model like Gemma to run free and fast. Vision can stay on auto-detect if your default model already supports it.

For the research model, the guide goes the opposite direction and picks a frontier model (Claude Opus 4.8) because deep research is a core Odysseus feature worth the higher cost. The teacher model is the clever part: when a cheaper agent fails a task, the teacher model (also set to a frontier model here) writes a reusable skill file so the cheaper models can do it next time. You pay the frontier price once to build the skill, then execute with economical open-source models. One Venice key gives you frontier, open-source, and private options side by side.

From there, Odysseus opens up: import the official Venice skills (image, audio, video, payments) by dragging the unzipped skill folders into a chat and asking an agent to install them; build personas and group chats that assign different models to different characters; run a model comparison to blind-test several models on the same task and vote on the best value; schedule tasks for email, calendar, and recurring research; and generate or edit images once the matching local model and dependencies are installed. Note that at recording time, inline image display inside Odysseus was not yet working, though generated images can be added to the gallery and edited.

Key takeaways

Adapted from the @askvenice video on YouTube. Models and prices change fast; verify current details in Venice before production use.