agentgog

CLI assistant that classifies short messages into CALENDAR, TASK, or MEMO and then:

CALENDAR → extracts event details and inserts into Google Calendar
TASK → extracts task details and inserts into Google Tasks
MEMO → extracts memo details and saves to Simplenote

It also provides a general chat command, plus extra utilities (translator, qrpayment, codeagent).

Install

This repo uses uv.

uv sync

Run from source:

uv run agentgog --help

AI Provider setup

OpenRouter (default)

Set API key via env var (preferred):

export OPENROUTER_API_KEY="<your_key>"

Or put the key in:

~/.openai_openrouter.key

Ollama (local)

Install and start Ollama:

ollama serve

Then use -p ollama.

llama.cpp (local)

Requires a running llama.cpp server (typically on port 8080):

# Default server URL: http://localhost:8080
uv run agentgog chat -p llama.cpp

# Custom URL via environment variable
export AGATA_LLAMACPP_URL="http://localhost:8080"
uv run agentgog chat -p llama.cpp

# Custom timeout (default: 90 seconds)
export AGATA_LLAMACPP_TIMEOUT=120
uv run agentgog chat -p llama.cpp

Model detection: The model is automatically detected from the server (/v1/models endpoint). You don't need to specify a model with -m - agata will query the server to find out what's loaded.

To test connectivity:

uv run agentgog test-llamacpp

Google setup (Calendar + Tasks)

Create OAuth client credentials in Google Cloud Console.
Save the JSON to:

~/.config/google/credentials.json

On first run, a browser window opens for authorization and a token is cached at:

~/.config/google/token.json

If you ever change scopes and get “insufficient authentication scopes”, delete the token and re-run:

rm -f ~/.config/google/token.json

Simplenote setup (MEMO)

Set credentials via environment variables:

export SIMPLENOTE_LOCAL_USER="user@example.com"
export SIMPLENOTE_LOCAL_PASSWORD="<your_password>"

Usage

Classify and execute

# Calendar event → Google Calendar
uv run agentgog classify "Meeting with Alice tomorrow at 10am"

# Task → Google Tasks (list: "My Tasks"; falls back to default)
uv run agentgog classify "Buy groceries tomorrow"

# Memo → Simplenote
uv run agentgog classify "Remember that my passport number is 123456789"

Choose provider

# Use OpenRouter explicitly
uv run agentgog classify "Buy groceries" -p openrouter

# Use local Ollama
uv run agentgog classify "Buy groceries" -p ollama

# Use local llama.cpp server
uv run agentgog classify "Buy groceries" -p llama.cpp

Chat

Single prompt:

# Use default provider (OpenRouter)
uv run agentgog chat "Explain the difference between TCP and UDP"

# Use llama.cpp local server
uv run agentgog chat "Explain the difference between TCP and UDP" -p llama.cpp

Interactive chat (keeps conversation history in-memory):

# Default provider
uv run agentgog chat

# With llama.cpp
uv run agentgog chat -p llama.cpp

Interactive commands:

Quit: /q, /quit, /exit, quit, exit
Clear conversation: /c, /clear, /reset, /r

Input line editing + persistent command history:

History file: ~/.agentgog_history

Translator (SRT → Czech)

Uses smolagents (OpenRouter only):

uv run agentgog translator -s subtitles.srt -m google/gemma-3-27b-it:free

QR payment

Uses smolagents (OpenRouter only):

uv run agentgog qrpayment "Transfer 500 CZK to account 1234567890/0300" -m google/gemma-3-27b-it:free

Code agent

Uses smolagents:

# With OpenRouter
uv run agentgog codeagent "Write a Python function to compute fibonacci" -m google/gemma-3-27b-it:free -x 10

# With local llama.cpp server
uv run agentgog codeagent "Say hello" -p llama.cpp

Example llama.cpp server setup:

llama-server -hf unsloth/gemma-4-E4B-it-GGUF \
  --threads 8 --ctx-size 4096 \
  --temp 0.8 --top-p 0.85 --top-k 40 \
  --repeat-penalty 1.1 --host 0.0.0.0 -ngl 0

Logging

Log file: ~/agentgog.log

Download files

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

Source Distribution

agentgog-0.1.38.tar.gz (101.1 kB view details)

Uploaded Aug 18, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agentgog-0.1.38-py3-none-any.whl (102.5 kB view details)

Uploaded Aug 18, 2026 Python 3

File details

Details for the file agentgog-0.1.38.tar.gz.

File metadata

Download URL: agentgog-0.1.38.tar.gz
Upload date: Aug 18, 2026
Size: 101.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.7

File hashes

Hashes for agentgog-0.1.38.tar.gz
Algorithm	Hash digest
SHA256	`e201701cc9c3c26d8ee196c77f616196dcb458ce4e3ff724c4e36b80c72ea2f9`
MD5	`d9954e0c580ba457cef57491c0fbe64b`
BLAKE2b-256	`ddd6ddc651ac648cd29f041f2656f1887314f0614d5e7744060b4adfcdb3bb29`

See more details on using hashes here.

File details

Details for the file agentgog-0.1.38-py3-none-any.whl.

File metadata

Download URL: agentgog-0.1.38-py3-none-any.whl
Upload date: Aug 18, 2026
Size: 102.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.7

File hashes

Hashes for agentgog-0.1.38-py3-none-any.whl
Algorithm	Hash digest
SHA256	`cdaf9443fc13e6ca3a04def1509e1f60ee8aaf1d503f091d47f80048e70b898b`
MD5	`dd5f49cb64b1de61da6463fbe06ed1cd`
BLAKE2b-256	`fb0b4d5b40820660cd5bb64abd0c14ca0ff3d1d5b5bc70262bb699289fb9205f`