Guides · v0.2.1
Step-by-step guides
Short guides for the jobs people do most, in the words on your screen. New to Eugene? Install it first.
Updating
- Update from v0.1.0 to v0.2.0
Update the control root first, then every other machine. What carries over, and the few things to do after.
Models and providers
- Use OpenRouter, Gemini or OpenAI beside local models
Use Gemini, OpenAI, OpenRouter, ElevenLabs, or your Claude Code or Codex subscription beside your local models, through one address.
- Add web search to your local models
Let models search the web through Brave, Google Search or SearXNG, and choose the order Eugene tries them.
- Run a local embedding model and reranker
Serve embeddings and reranking from your own machine, for Workbench and for Open WebUI's document search.
- See which models fit your GPU before you download
Check which models fit this machine's graphics memory (VRAM) before you download, add a model hub with its own token, and delete a model safely.
Apps
- Use Claude Code or Codex with local models
Point Claude Code or Codex at your own local models, with one address and a key from the console.
- Set up local RAG with Open WebUI or your own code
Answer from your own documents with local models, in Workbench, Open WebUI or your own code.
- Install Workbench
Install Eugene's chat app on any of your machines, and sign in with Eugene.
- Have Workbench remember things
Keep notes Workbench gives the model in your chats, see what each chat sent, and choose what models outside your machines get.
- Chat with your documents and PDFs in Workbench
Attach a file to one chat, or keep documents and folders to search, with each passage cited by file and page.
- Add MCP tools and folders to Workbench
Grant a folder, add MCP tool servers, and approve each call in the chat.
Machines
- Set up a Job Site
Let Workbench work on a person's own machine, wherever it is, with no incoming connections.
- Add a warm standby
Keep a second machine ready to take over as the control root.
- Serve the container on one HTTPS port
Optional: put the console and Workbench behind one HTTPS port, each with its own name.