Skip to main content

LLM CLI engineered for developer workflows. Built on **Hexagonal Architecture** for strict typing, modularity, and speed

Project description

DragonGlass (dg)

DragonGlass CLI Python Gemini

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-001 for 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


Download files

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

Source Distribution

dragonglass-0.1.0b1.tar.gz (175.4 kB view details)

Uploaded Source

Built Distribution

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

dragonglass-0.1.0b1-py3-none-any.whl (18.5 kB view details)

Uploaded Python 3

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

Hashes for dragonglass-0.1.0b1.tar.gz
Algorithm Hash digest
SHA256 62fe73132c8ccb3a200886550e32d6db75c3d895239c7effc7c675f75cd3cf47
MD5 0a217674fa8130addc7e05a88cb35fef
BLAKE2b-256 caae5e79d6233bc1ea8b4f7e6c6cfc586eae6d6ed01d3109e71a1e90a43d8e09

See more details on using hashes here.

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

Hashes for dragonglass-0.1.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 850e59a456f96aa3b09a7f66829dbac031d48f97294850144d723dad467ad9c1
MD5 45b66ea417981ba5e9dc4e4416e00bb8
BLAKE2b-256 4480fd3df73535d7ff4ec33d617753dbdaf984c726a938c4a484c5d122a23baf

See more details on using hashes here.

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