dasshh 0.1.3

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

🗲   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

📸 Screenshots

📦 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:

model:
  name: 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

The documentation is available at https://vgnshiyer.github.io/dasshh/.

Running the docs locally

# Install dependencies
uv pip install mkdocs-material

# Serve the documentation
mkdocs serve

Then visit http://localhost:8000 in your browser.

🤝 Contributing

Contributions are welcome! Please open an issue with your suggestions or feature requests.

🛠️ Development

Clone the repository

git clone https://github.com/vgnshiyer/dasshh.git
cd dasshh

Install dependencies

uv sync

Run the app

python -m dasshh

📝 License

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