Skip to main content

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

Project description

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


PyPI License: MIT Buy Me A Coffee

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

Dasshh Demo

📦 Installation

Using uv

brew install uv  # macOS
uvx dasshh

Prefer pipx?

pipx install dasshh

Initial Setup

Before running the app, you need to initialize the configuration file:

dasshh init-config

This will create a configuration file at ~/.dasshh/config.yaml. You need to edit this file to set your API key and other preferences:

# Edit the file to set your model API key
model:
  name: gemini/gemini-2.0-flash
  api_key: YOUR_API_KEY_HERE

Checkout litellm docs for detailed model configuration.

Running the app

dasshh

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dasshh-0.1.2.tar.gz (26.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dasshh-0.1.2-py3-none-any.whl (36.9 kB view details)

Uploaded Python 3

File details

Details for the file dasshh-0.1.2.tar.gz.

File metadata

  • Download URL: dasshh-0.1.2.tar.gz
  • Upload date:
  • Size: 26.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dasshh-0.1.2.tar.gz
Algorithm Hash digest
SHA256 4d8d0ce2195c2b93db132de52b031a0a8ef0dc949dc29bf68027a397240952f8
MD5 1cc2bf7da270b8297b70c4a10f1490c9
BLAKE2b-256 cb69eeaaccdd76e6905ff14c8685990e90b31c71070488aa4beaf2439be0534b

See more details on using hashes here.

Provenance

The following attestation bundles were made for dasshh-0.1.2.tar.gz:

Publisher: publish.yml on vgnshiyer/dasshh

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dasshh-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: dasshh-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 36.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dasshh-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3e6a5d96fd309be8b5c3960cab04e0b08d6dc0331d585c1b3fdc28941c4fef6f
MD5 f08cca599a7fdeabe64db5d2669fa424
BLAKE2b-256 8f9c8c79f523297774fea0adaf9014527c99bc2234b20fbe2406cd11f8d58c77

See more details on using hashes here.

Provenance

The following attestation bundles were made for dasshh-0.1.2-py3-none-any.whl:

Publisher: publish.yml on vgnshiyer/dasshh

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page