ℹ️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:

1. Install the terminal UI:

npm install -g theseus-tui

1. 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

1. 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:

1. Get deepseek running with ollama
2. Start the local ollama server:

ollama run deepseek-coder:6.7b

1. Configure Theseus:

theseus-tui configure# Select "ollama/deepseek-coder:6.7b" from the model options

1. 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:

1. Ensure all prerequisites are properly installed

2. Check that your API key is valid and properly set

3. 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