Metadata-Version: 2.4
Name: dasshh
Version: 0.1.4
Summary: An AI Agent on your terminal, to preserve your brain juice.
Author-email: Vignesh Iyer <vgnshiyer@gmail.com>
License: MIT
Project-URL: Documentation, https://blog.vgnshiyer.dev/dasshh
Project-URL: Homepage, https://github.com/vgnshiyer/dasshh
Project-URL: Repository, https://github.com/vgnshiyer/dasshh
Project-URL: Bug Tracker, https://github.com/vgnshiyer/dasshh/issues
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.2.0
Requires-Dist: litellm>=1.69.3
Requires-Dist: numpydoc>=1.8.0
Requires-Dist: psutil>=7.0.0
Requires-Dist: sqlalchemy>=2.0.41
Requires-Dist: textual>=3.2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: mkdocs-material>=9.6.0; extra == "dev"
Dynamic: license-file

<div align="center">

# 🗲 &nbsp; *Dasshh* &nbsp; 🗲

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

Dasshh is a tui built with [textual](https://textual.textualize.io/) that allows you to interact with your computer using natural language.

</div>

<hr>

[![PyPI](https://img.shields.io/pypi/v/dasshh.svg)](https://pypi.org/project/dasshh/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![CI](https://github.com/vgnshiyer/dasshh/workflows/CI/badge.svg)](https://github.com/vgnshiyer/dasshh/actions/workflows/ci.yml)
[![](https://img.shields.io/badge/Follow-vgnshiyer-0A66C2?logo=linkedin)](https://www.linkedin.com/comm/mynetwork/discovery-see-all?usecase=PEOPLE_FOLLOWS&followMember=vgnshiyer)
[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Donate-yellow.svg?logo=buymeacoffee)](https://www.buymeacoffee.com/vgnshiyer)

<img src="assets/feature1.gif" alt="Dasshh Demo" width="800">

**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](https://github.com/astral-sh/uv) yet, it's highly recommended for fast Python package management.

```bash
# 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`

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

# Install dasshh
pipx install dasshh
```

### Verify Installation

```bash
dasshh --version
```

## 🚀 Quick Start

### 1. Initialize Configuration

```bash
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:

```yaml
model:
  name: gemini/gemini-2.0-flash
  api_key: <your-google-AI-studio-api-key>
```

> See [litellm docs](https://docs.litellm.ai/docs/providers) for all supported models and providers.

### 3. Launch Dasshh

```bash
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/](https://vgnshiyer.github.io/dasshh/).

## 🤝 Contributing

We welcome contributions! 🎉 

- **Read our [Contributing Guide](CONTRIBUTING.md)** for development setup and guidelines
- **Report bugs** using our [issue templates](.github/ISSUE_TEMPLATE/)
- **Request features** or ask questions in our [discussions](https://github.com/vgnshiyer/dasshh/discussions)
- **Improve documentation** - we appreciate all help!

## 📝 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

