arrow-left

Only this pageAll pages
gitbookPowered by GitBook
1 of 9

Theseus Docs

Getting Started

Loading...

Loading...

Loading...

Loading...

Basics

Loading...

Loading...

Loading...

Installation Guide

Installation Guide; This guide will walk you through the process of installing Theseus on your system.

hashtag
###3. Install and Run UI

Install and run the main UI using npx:

That's it! You're ready to start using Theseus.

hashtag
##Updating Theseus

If you already have Theseus installed, you can update it using:

hashtag
##Terminal UI Installation (Optional)

If you prefer using the terminal interface:

  1. Install the terminal UI:

  1. Set your API key as an environment variable:

  1. Run the terminal UI:

To update the terminal UI:

hashtag
##Running in Debug Mode

To run in debug mode:

hashtag
##Local Model Support (Experimental)

To run with a local model:

  1. Get deepseek running with

  2. Start the local ollama server:

  1. Configure Theseus:

  1. Run with local configuration:

Warning: Local model support is currently experimental. Expect reduced performance compared to cloud-based models.

hashtag
##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:

hashtag
##Next Steps

  • Check out the to begin using Theseus

  • Review the to customize your setup

  • Explore the to learn about Theseus capabilities

pipx install theseus_agent
npx theseus-ui
ollamaarrow-up-right
Quick Start Guide
Configuration Guide
Features Overview
pipx install --force theseus_agent
npm install -g theseus-tui
# For Anthropicexport ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx# OR for OpenAIexport OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx# OR for Groqexport GROQ_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
theseus-tui
npm uninstall -g theseus-tuinpm install -g theseus-tui
theseus-tui --debug
ollama run deepseek-coder:6.7b
theseus-tui configure# Select "ollama/deepseek-coder:6.7b" from the model options
theseus-tui --api_key=FOSS
npm uninstall -g theseus-tuinpm install -g theseus-tui

Overview

  • Claude 3.5 Sonnet

  • GPT4-o

  • Groq llama3-70b

  • Ollama deepseek-6.7b

hashtag
###Local Models (Experimental)

  • Support for running models locally using Ollama

  • Currently supports deepseek-coder:6.7b

  • More local models coming soon

hashtag
##Interface Options

hashtag
###Main UI

  • Modern, intuitive interface

  • Real-time collaboration features

  • Integrated file management

  • Command palette for quick actions

hashtag
###Terminal UI

  • Lightweight terminal-based interface

  • Perfect for terminal-centric workflows

  • Full feature parity with main UI

hashtag
###Electron App

  • Self-hostable desktop application

  • Native system integration

  • Offline capabilities

  • Enhanced performance

hashtag
##Development Features

hashtag
###Version Control Integration

  • Git-aware operations

  • Branch management

  • Commit suggestions

  • Change tracking

hashtag
###Project Management

  • Project-level configuration

  • Environment management

  • Dependency handling

  • Build system integration

hashtag
##Coming Soon

We're actively working on new features including:

  • Google Gemini 1.5 Pro support

  • Plugin system for tool and agent builders

  • Enhanced Electron app capabilities

hashtag
##Limitations

Current known limitations include:

  • Minimal functionality for non-Python languages

  • Sometimes requires explicit file specification for changes

  • Local mode is currently experimental

hashtag
##Getting Started

To start using these features:

  1. Check out the

  2. Follow the

  3. Review

For detailed information about specific features, check out the individual feature documentation in the sidebar.

Customizable configuration
Improved performance on SWE-bench Lite
Windows support is in development
Installation Guide
Quick Start Guide
Basic Usage

Introducing Theseus

Theseus will transforming DeFi by delivering advanced yield optimization powered by intelligent our AI Agent and revolutionary AI tools.

hashtag
What sets Theseus Apart?

Theseus simplifies yield generation by leveraging two innovative strategies:

Auto-Yield Strategy

Our flagship Auto-Yield feature acts as your personal DeFi fund manager:

  • Automatically distributes your assets across leading Solana protocols.

  • Continuously monitors market conditions to optimize yields.

  • Prioritizes security and risk management, ideal for users who prefer a hands-off approach.

Theseus Agent: Your AI DeFi Assistant

Theseus offers real-time market analysis and powerful decision-making tools via an intuitive chat interface:

  • Real-time token and protocol security analysis.

  • Comprehensive market sentiment evaluation.

  • Strategic investment recommendations tailored to your preferences.


hashtag
🎯 Core Features

Intelligent Yield Optimization

Our sophisticated AI-driven system actively analyzes market conditions, protocol health, and yield opportunities to dynamically rebalance your assets, ensuring optimal allocation aligned with your risk tolerance.

AI-Powered Market Insights

Theseus AI continually scans tokens and DeFi protocols, providing:

  • Real-time security scans of smart contracts.

  • Sentiment analysis from multiple market data sources.

  • Predictive insights for navigating market trends and risks.

Robust Security Infrastructure

Theseus also prioritizes your security through:

  • Non-custodial design, ensuring complete user control over assets.

  • Multi-layered security with real-time monitoring.

  • Continuous protocol health assessments and automated risk management.


hashtag
📈 How Yield Optimization Works

Our yield optimization engine constantly evaluates a comprehensive set of factors:

  • Current and historical APY rates.

  • Protocol security and stability metrics.

  • Real-time market conditions and liquidity analysis.

This holistic approach ensures sustained yield performance while maintaining stringent risk controls.


hashtag
🤖 AI-Assisted Decision Making

Our AI Agents enhances your decision-making with sophisticated AI capabilities:

  • Deep token security assessments.

  • Dynamic market condition evaluations.

  • Personalized recommendations to optimize returns.


hashtag
🔐 Advanced Risk Management

We implement rigorous, proactive risk management practices:

  • Protocol diversification to mitigate risk.

  • Real-time tracking of protocol health and market dynamics.

  • Automatic asset reallocation based on predefined risk parameters.


hashtag
🖥️ User-Friendly Experience

Our intuitive user interface and dashboard make complex DeFi operations simple:

  • Easily track portfolio performance and yield generation.

  • Execute deposits, withdrawals, and strategy adjustments effortlessly.

  • Engage naturally with Agent Neo to simplify strategy management.


hashtag
📚 Getting Started

Begin your DeFi optimization journey here! Theseus provides all the tools you need for smarter, safer yield generation. Follow our comprehensive guides and leverage the power of AI to revolutionize your DeFi experience.

Quick-action transactions directly through chat interactions.
Regular, independent security audits.
Continuous monitoring and risk management, enabling safer investments.
Emergency safeguards and rapid response capabilities.

Basic Usage

  • Backtest thoroughly

  • Use paper trading

  • Monitor live performance

  • Regular strategy validation

hashtag
###4. Security

  • Audit smart contracts

  • Use secure wallets

  • Monitor transactions

  • Regular security reviews

hashtag
##Working with Different Interfaces

hashtag
###Terminal UI

The terminal interface provides a focused, keyboard-driven experience:

hashtag
###Main UI

The graphical interface offers additional features:

  • File tree navigation

  • Integrated editor

  • Visual diff viewing

  • Command palette

hashtag
###Electron App

The desktop application provides:

  • Native system integration

  • Offline capabilities

  • Enhanced performance

  • Local file system access

hashtag
##Tips for Efficiency

  1. Use Project-Wide Context

    • Let Theseus understand your entire codebase

    • Reference related files and modules

hashtag
##Common Patterns

hashtag
###Code Review

hashtag
###Feature Development

hashtag
###Bug Fixing

hashtag
##Next Steps

  • Explore the

  • Review

  • Check out the

Multiple panels

Explain architectural decisions
  • Leverage Incremental Changes

    • Make small, focused modifications

    • Review each change

    • Build complexity gradually

  • Maintain Clear Communication

    • Be specific in requests

    • Provide necessary context

    • Ask for clarification

  • Utilize Version Control

    • Work in feature branches

    • Review changes carefully

    • Keep meaningful history

  • Features Overview
    Configuration Options
    Quick Start Guide
    # Start in terminal modetheseus-tui# Navigate historyUse up/down arrow keys# Interrupt operationsCtrl+C# ExitCtrl+D
    # Request review"Review this implementation"# Address feedback"Apply the suggested improvements"# Verify changes"Run the tests to verify"
    # Plan implementation"How should we implement this feature?"# Execute plan"Let's start with the basic structure"# Iterate and refine"Now add error handling"
    # Describe issue"The app crashes when..."# Investigate"Can you help find the cause?"# Apply fix"Implement the solution"# Verify"Add tests to prevent regression"

    Configuration Guide

    hashtag
    ###Cache Settings

    Configure caching behavior:

    hashtag
    ##Security Settings

    hashtag
    ###Access Control

    Limit file access:

    hashtag
    ###API Security

    Secure API usage:

    hashtag
    ##Customization

    hashtag
    ###Custom Commands

    Add custom commands in your configuration:

    hashtag
    ###Shortcuts

    Configure keyboard shortcuts:

    hashtag
    ##Troubleshooting

    hashtag
    ###Configuration Validation

    Verify your configuration:

    hashtag
    ###Debug Mode

    Enable debug logging:

    hashtag
    ###Reset Configuration

    Reset to default settings:

    hashtag
    ##Next Steps

    • Review

    • Explore

    • Check out the

    export THESEUS_MAX_MEMORY=4096
    # Set cache directoryexport THESEUS_CACHE_DIR=/path/to/cache# Set cache size limitexport THESEUS_CACHE_SIZE=1024
    Basic Usage
    Features Overview
    Quick Start Guide
    # Restrict to specific directoriesexport THESEUS_ALLOWED_PATHS=/path/to/projects# Block sensitive directoriesexport THESEUS_BLOCKED_PATHS=/path/to/sensitive
    # Enable secure modeexport THESEUS_SECURE_MODE=true# Set API request timeoutexport THESEUS_API_TIMEOUT=30
    {
      "customCommands": {
        "myCommand": {
          "script": "/path/to/script.sh",
          "description": "Custom command description"
        }
      }
    }
    {
      "shortcuts": {
        "togglePanel": "cmd+shift+p",
        "quickAction": "ctrl+space"
      }
    }
    theseus-tui verify-config
    export THESEUS_DEBUG=truetheseus-tui --debug
    theseus-tui reset-config

    Tokenomics & Economics Distribution

    hashtag
    🪙 $THES Tokenomics & Economics Distribution

    The $THES token is central to Theseus, designed to align the interests of stakeholders, support sustainable growth, ensure fair distribution.

    📤 Token Distribution

    Total Supply: 1,000,000,000 $THES

    The token distribution structure promotes sustainability, transparency, and community-driven growth.

    🚧 Development Fund (10%)

    • Allocation: 100,000,000 $THES

    • Purpose: Fund ongoing operational expenses, development, and improvements.

    • Vesting: 6-month cliff followed by 12-month linear vesting (total of 18 months).

    Detailed Usage Breakdown:

    • 40%: Core development and engineering

    • 25%: Security audits and ongoing safety measures

    • 20%: Infrastructure maintenance and operations

    This fund ensures continued development of the infrastructure, enhances AI capabilities, improves yield optimization algorithms, and reinforces security.


    hashtag
    Fair Launch on pump.fun

    Theseus utilizes pump.fun for a fair and transparent token launch, which:

    • Prevents whale manipulation

    • Ensures equitable access for all participants

    • Establishes broad token holder distribution


    hashtag
    ⏳ Token Vesting Schedule

    Our vesting strategy ensures stakeholder alignment and sustainable, long-term growth.

    Development Fund Vesting

    • Cliff Period: 6 months

    • Vesting Period: 12 months (post-cliff)

    • Unlock Schedule: Daily linear unlocks after cliff

    15%: Technical research and protocol innovation
    Promotes fair and stable market valuation
    Total Duration: 18 months

    Quick Start

    hashtag
    ###3. Best Practices

    • Be specific in your requests

    • Provide context when needed

    • Review suggested changes before applying

    • Use version control for safety

    hashtag
    ##Example Interactions

    hashtag
    ###Bug Fixing

    hashtag
    ###Feature Addition

    hashtag
    ##Tips for Success

    1. Clear Communication

      • Be specific about what you want to achieve

      • Provide necessary context

    hashtag
    ##Keyboard Shortcuts

    hashtag
    ###Terminal UI

    • Ctrl+C: Interrupt current operation

    • Ctrl+D: Exit Theseus

    • Arrow keys: Navigate history

    hashtag
    ###Main UI

    • Command palette: Access common actions

    • File navigation: Browse project structure

    • Quick commands: Perform frequent tasks

    hashtag
    ##Next Steps

    • Explore the

    • Learn about

    • Check out

    hashtag
    ##Getting Help

    If you encounter issues:

    1. Check the

    2. Review common solutions in our documentation

    3. Reach out to the community on Twitter @Theseus_XYZ

    Remember: Theseus is designed to be your coding companion. Take time to explore its capabilities and find the workflow that works best for you.

    Ask for clarification if needed
  • Iterative Development

    • Start with small, focused tasks

    • Review and refine solutions

    • Build complexity gradually

  • Safety First

    • Work in a version-controlled environment

    • Review changes before applying

    • Keep backups of important files

  • Effective Collaboration

    • Use Theseus as a pair programmer

    • Ask for explanations when needed

    • Learn from suggested solutions

  • Review Configuration Options
    File an issue on GitHub if needed
    Features Overview
    Advanced Usage
    Best Practices
    Troubleshooting Guide
    You: "I'm getting a TypeError in my authentication module"
    Theseus: *Analyzes code and suggests fixes*
    You: "Apply the suggested fix"
    Theseus: *Makes changes and verifies*
    You: "Add input validation to the user registration form"
    Theseus: *Suggests implementation*
    You: "Looks good, implement it"
    Theseus: *Adds the feature and tests*