console-agent 1.2.3

█▀▀ █▀█ █▄ █ █▀ █▀█ █   █▀▀
█▄▄ █▄█ █ ▀█ ▄█ █▄█ █▄▄ ██▄
       .agent

agent("debug this") — as easy as print()

Drop agent() anywhere in your Python code to execute agentic AI workflows. Powered by Google Gemini & Ollama via Agno.

⚡ Quick Start

pip install console-agent

from console_agent import agent, init

# Optional: configure (works with sensible defaults + GEMINI_API_KEY env var)
init(api_key="your-key", model="gemini-2.5-flash-lite")

# Fire-and-forget — just like print()
agent("analyze this error", context=error)

# Get structured results
result = agent("validate email format", context=email, mode="blocking")
print(result.summary)
print(result.confidence)

🎭 Persona Shortcuts

Each persona has a specialized system prompt optimized for its domain:

# 🛡️ Security audit
agent.security("audit this SQL query", context=query)

# 🐛 Debug analysis
agent.debug("investigate slow query", context={"duration": dur, "sql": sql})

# 🏗️ Architecture review
agent.architect("review API design", context=endpoint)

Personas are auto-detected from prompt keywords, or you can force one:

agent("analyze this code", persona="security")

🔄 Async Support

# Native async
result = await agent.arun("analyze this", context=data)

# Works in Jupyter notebooks too!

🔌 Providers

Google Gemini (default)

Cloud-hosted, full tool support, API key required.

from console_agent import init

init(
    provider="google",                # default
    api_key="...",                    # or set GEMINI_API_KEY env var
    model="gemini-2.5-flash-lite",   # default model
)

Ollama (Local Models)

Run models locally with Ollama. Free, private, no API key needed.

# 1. Install Ollama: https://ollama.com
# 2. Pull a model
ollama pull llama3.2

from console_agent import init

init(
    provider="ollama",
    model="llama3.2",                         # any model from `ollama list`
    ollama_host="http://localhost:11434",      # default
)

Provider Comparison

⚙️ Configuration

from console_agent import init

init(
    provider="google",                # "google" | "ollama"
    api_key="...",                    # or set GEMINI_API_KEY env var
    model="gemini-2.5-flash-lite",   # default model
    ollama_host="http://localhost:11434",  # Ollama host (when provider="ollama")
    persona="general",               # default persona
    mode="fire-and-forget",          # or "blocking"
    timeout=10000,                   # ms before timeout
    anonymize=True,                  # auto-strip secrets/PII
    dry_run=False,                   # log without calling API
    log_level="info",                # silent | errors | info | debug
    budget={
        "max_calls_per_day": 100,
        "max_tokens_per_call": 8000,
        "cost_cap_daily": 1.0,
    },
)

📊 Structured Output

Get typed responses using Pydantic models:

from pydantic import BaseModel

class CodeReview(BaseModel):
    issues: list[str]
    severity: str
    suggestion: str

result = agent(
    "review this function",
    context=code,
    schema_model=CodeReview,
)
# result.data is a dict matching CodeReview fields

🔒 Built-in Safety

• PII/Secret anonymization — auto-strips API keys, emails, IPs, tokens before sending
• Rate limiting — token bucket algorithm prevents abuse
• Budget tracking — daily call limits, token caps, and cost caps
• Dry run mode — log prompts without making API calls

🧪 Testing

# Install dev dependencies
pip install -e ".[dev]"

# Run unit tests
pytest tests/unit/ -v

# Run integration tests (dry run, no API key needed)
pytest tests/integration/ -v

# Run e2e tests (requires GEMINI_API_KEY)
GEMINI_API_KEY=your-key pytest tests/e2e/ -v

📦 Architecture

console_agent/
├── __init__.py          # Public API: agent(), init()
├── types.py             # Pydantic models (AgentResult, AgentConfig, etc.)
├── core.py              # Agent engine (orchestration, budget, rate-limit)
├── personas/            # Specialized AI personas
│   ├── general.py       # 🔍 General-purpose
│   ├── debugger.py      # 🐛 Error analysis
│   ├── security.py      # �️ Security audit
│   └── architect.py     # 🏗️ Architecture review
├── providers/
│   ├── google.py        # Agno + Gemini integration
│   └── ollama.py        # Agno + Ollama integration (local models)
├── utils/
│   ├── anonymize.py     # PII/secret stripping
│   ├── rate_limit.py    # Token bucket rate limiter
│   ├── budget.py        # Daily budget tracker
│   └── format.py        # Rich console output
└── tools/
    ├── code_execution.py
    ├── search.py
    └── file_analysis.py

🔗 Also Available

• Node.js: @console-agent/agent
• Docs: console-agent.github.io
• GitHub: github.com/console-agent

License

MIT © Console Agent