🗲   Dasshh   🗲

An AI Agent on your terminal, to preserve your brain juice.

Dasshh is a tui built with textual that allows you to interact with your computer using natural language.

---

Note: This project is still in early development. Suggestions and contributions are welcome!

✨ Features

• Interactive & minimal chat UI
• Chat with your personal assistant on your terminal
• Perform actions on your computer with plain English
• Extensible with your own tools

📦 Installation

Using uv (Recommended)

If you haven't tried uv yet, it's highly recommended for fast Python package management.

# Install uv on macOS
brew install uv

# Or using curl
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dasshh
uv tool install dasshh

Using pipx

# Install pipx if you haven't already
pip install --user pipx
pipx ensurepath

# Install dasshh
pipx install dasshh

Verify Installation

dasshh --version

🚀 Quick Start

1. Initialize Configuration

dasshh init-config

This creates a config file at ~/.dasshh/config.yaml.

2. Configure Your Model

Edit the config file to set your model and API key:

dasshh:
  selected_model: my-gemini  # Select which model to use

models:
  - model_name: my-gemini
    litellm_params:
      model: gemini/gemini-2.0-flash
      api_key: <your-google-AI-studio-api-key>

See litellm docs for all supported models and providers.

3. Launch Dasshh

dasshh

4. Start Chatting

Ask Dasshh to help with system tasks:

• What's the current CPU usage?
• Show me the top memory-intensive processes  
• List files in my downloads folder
• Create a new directory called "projects"

Exit: Press Ctrl+C to terminate.

📖 Documentation

For comprehensive documentation, visit https://vgnshiyer.github.io/dasshh/.

🤝 Contributing

We welcome contributions! 🎉

• Read our Contributing Guide for development setup and guidelines
• Report bugs using our issue templates
• Request features or ask questions in our discussions
• Improve documentation - we appreciate all help!

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.