âšī¸Installation Guide
Installation Guide; This guide will walk you through the process of installing Theseus on your system.
pipx install theseus_agent
###3. Install and Run UI
Install and run the main UI using npx:
npx theseus-ui
That's it! You're ready to start using Theseus.
##Updating Theseus
If you already have Theseus installed, you can update it using:
pipx install --force theseus_agent
##Terminal UI Installation (Optional)
If you prefer using the terminal interface:
Install the terminal UI:
npm install -g theseus-tui
Set your API key as an environment variable:
# For Anthropicexport ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx# OR for OpenAIexport OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx# OR for Groqexport GROQ_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Run the terminal UI:
theseus-tui
To update the terminal UI:
npm uninstall -g theseus-tuinpm install -g theseus-tui
##Running in Debug Mode
To run in debug mode:
theseus-tui --debug
##Local Model Support (Experimental)
To run with a local model:
Get deepseek running with ollama
Start the local ollama server:
ollama run deepseek-coder:6.7b
Configure Theseus:
theseus-tui configure# Select "ollama/deepseek-coder:6.7b" from the model options
Run with local configuration:
theseus-tui --api_key=FOSS
Warning: Local model support is currently experimental. Expect reduced performance compared to cloud-based models.
##Troubleshooting
If you encounter any issues during installation:
Ensure all prerequisites are properly installed
Check that your API key is valid and properly set
For terminal UI issues, try a clean reinstall:
npm uninstall -g theseus-tuinpm install -g theseus-tui
##Next Steps
Check out the Quick Start Guide to begin using Theseus
Review the Configuration Guide to customize your setup
Explore the Features Overview to learn about Theseus capabilities
Last updated