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.
  • 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.0b2.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.0b2-py3-none-any.whl (18.5 kB view details)

Uploaded Python 3

File details

Details for the file dragonglass-0.1.0b2.tar.gz.

File metadata

  • Download URL: dragonglass-0.1.0b2.tar.gz
  • Upload date:
  • Size: 175.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.17

File hashes

Hashes for dragonglass-0.1.0b2.tar.gz
Algorithm Hash digest
SHA256 2385620696106af6c0abd45b8c6f53d9ac0f817d7f0c53427b34548571149957
MD5 302caa8fa7349729a4e7730899e51030
BLAKE2b-256 b8edbede355c9479b33d7f3d74d72bcde7acc70d9ca1a417b744ce7c20129a3f

See more details on using hashes here.

File details

Details for the file dragonglass-0.1.0b2-py3-none-any.whl.

File metadata

  • Download URL: dragonglass-0.1.0b2-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.10.17

File hashes

Hashes for dragonglass-0.1.0b2-py3-none-any.whl
Algorithm Hash digest
SHA256 c2698dff53530c10b3a34b663ad756e9eab63bafc163194472333885e8c1c9d5
MD5 144cf876ac0b4484151dfb1df55bca8c
BLAKE2b-256 20c416fcb2b85b1ce0a8f268758e5cb57e7926027d1e5e1e9f653fcdb86a006a

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