aurumaide 0.1.0

Personal AI assistant — Aurum (gold) + Aide (helper)

AurumAide

Personal AI assistant — Aurum (Latin for gold) + Aide (helper).

Powered by Google Generative AI.

Prerequisites

• Python 3.12+
• A Google AI API key set in a .env file or as an environment variable

Setup

python -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

pip install -e ".[dev]"

Usage

aurumaide [options] [arguments...]

Positional arguments are joined by spaces to form the initial query. Without a query the assistant starts in interactive mode.

Options

Option	Description
--model MODEL	Google AI model to use (default: gemini-2.0-flash)
--one-shot	Answer the query and exit (requires a query)
--file FILE_PATH	Read the query from a file (cannot be combined with positional arguments)

Examples

# Interactive chat
aurumaide

# Ask a question and continue chatting
aurumaide What is the meaning of life

# One-shot: get an answer and exit
aurumaide --one-shot Explain the Python GIL

# Use a specific model
aurumaide --model gemini-2.5-pro Tell me about quantum computing

# Read the query from a file
aurumaide --one-shot --file query.txt

Development

# Run tests
pytest

# Lint & format
ruff check .
ruff format .

# Type checking
mypy src

License

MIT