LLM CLI engineered for developer workflows. Built on **Hexagonal Architecture** for strict typing, modularity, and speed
Project description
DragonGlass (dg)
LLM CLI engineered for developer workflows. Built on Hexagonal Architecture for strict typing, modularity, and speed.
██████╗ ██████╗ █████╗ ██████╗ ██████╗ ███╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██╔════╝ █ ██╝████╗ ██║
██║ ██║██████╔╝███████║██║ ███╗██║ █ ╗██╔██╗ ██║
██║ ██║██╔══██╗██╔══██║██║ ██║██║ ██║██║╚██╗██║
██████╔╝██║ ██║██║ ██║╚██████╔╝╚██████╔╝██║ ╚████║
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═══╝
██████╗ ██╗ █████╗ ███████╗███████╗
██╔════╝ ██║ ██╔══██╗██╔════╝██╔════╝
██║ ███╗██║ ███████║███████╗███████╗
██║ ██║██║ ██╔══██║╚════██║╚════██║
╚██████╔╝███████╗██║ ██║███████║███████║
╚═════╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚══════╝
$ dg
$ cat error.log | dg chat "Analyze the log"
$ cat error.log | dg chat "Fix the Error" --image screenshot.png
Features
Optimized for the Google Gemini ecosystem.
- Multimodal: Native support for text, images, and audio (coming soon).
- Fast: Streams responses in real-time.
- Efficient: Uses
gemini-embedding-001for high-quality semantic search. - Unix Philosophy: Designed to be piped.
- cat logs.txt | dg chat "Analyze this error" --image screenshot.png
- Hexagonal Architecture: Core logic is completely decoupled from infrastructure (DB, API).
- XDG Compliant: respect your system's config standards (
~/.config/dg,~/.local/share/dg).
Installation
Requires Python 3.10+.
pip install dragonglass
Configuration
Set your Gemini API key via environment variable:
export GOOGLE_API_KEY="your-api-key-here"
Or run a command, and dg will guide you.
Usage
cat error.log | python -m dg chat "Fix this error" --image screenshot.png # Multimodal One-Shot (Pipe + Image)
Pipelines
Process files and data streams.
# Summarize a README
cat README.md | dg chat "Summarize the key features"
History
View your conversation logs.
dg log
Roadmap
- Core Architecture (Hexagonal)
- Gemini Integration (Streaming)
- SQLite Persistence
- Local RAG (Numpy + Embeddings)
- Interactive TUI: Full chat interface with
Textual. - Multimodal Inputs:
dg chat --image screenshot.png "Fix this UI" - Project Awareness: Auto-index git repositories for context.
LICENSE
Apache License 2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dragonglass-0.1.0b1.tar.gz.
File metadata
- Download URL: dragonglass-0.1.0b1.tar.gz
- Upload date:
- Size: 175.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
62fe73132c8ccb3a200886550e32d6db75c3d895239c7effc7c675f75cd3cf47
|
|
| MD5 |
0a217674fa8130addc7e05a88cb35fef
|
|
| BLAKE2b-256 |
caae5e79d6233bc1ea8b4f7e6c6cfc586eae6d6ed01d3109e71a1e90a43d8e09
|
File details
Details for the file dragonglass-0.1.0b1-py3-none-any.whl.
File metadata
- Download URL: dragonglass-0.1.0b1-py3-none-any.whl
- Upload date:
- Size: 18.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
850e59a456f96aa3b09a7f66829dbac031d48f97294850144d723dad467ad9c1
|
|
| MD5 |
45b66ea417981ba5e9dc4e4416e00bb8
|
|
| BLAKE2b-256 |
4480fd3df73535d7ff4ec33d617753dbdaf984c726a938c4a484c5d122a23baf
|