DragonGlass

██████╗ ██████╗  █████╗  ██████╗  ██████╗ ███╗   ██╗
██╔══██╗██╔══██╗██╔══██╗██╔════╝ █     ██╝████╗  ██║
██║  ██║██████╔╝███████║██║  ███╗██║   █ ╗██╔██╗ ██║
██║  ██║██╔══██╗██╔══██║██║   ██║██║   ██║██║╚██╗██║
██████╔╝██║  ██║██║  ██║╚██████╔╝╚██████╔╝██║ ╚████║
╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝

             ██████╗ ██╗      █████╗ ███████╗███████╗
            ██╔════╝ ██║     ██╔══██╗██╔════╝██╔════╝
            ██║  ███╗██║     ███████║███████╗███████╗  
            ██║   ██║██║     ██╔══██║╚════██║╚════██║  
            ╚██████╔╝███████╗██║  ██║███████║███████║
             ╚═════╝ ╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝

$ 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+.

pipx install dragonglass

Configuration

Set your Gemini API key via environment variable:

Linux: ~/.config/dg/config.toml                                           
macOS: ~/Library/Application Support/dg/config.toml

# config.toml
    [gemini]
    google_api_key="A....D2E"
    default_model="gemini-3-pro-preview"
    temperature=0.7
    top_p=1.0
    safe_settings="BLOCK_NONE"
    grounding_enabled=true

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