Skip to main content

Add your description here

Project description

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.

Google setup (Calendar + Tasks)

  1. Create OAuth client credentials in Google Cloud Console.
  2. 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

Chat

Single prompt:

uv run agentgog chat "Explain the difference between TCP and UDP"

Interactive chat (keeps conversation history in-memory):

uv run agentgog chat -i

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:

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

Logging

  • Log file: ~/agentgog.log

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

agentgog-0.1.23.tar.gz (99.0 kB view details)

Uploaded Source

Built Distribution

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

agentgog-0.1.23-py3-none-any.whl (76.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentgog-0.1.23.tar.gz
  • Upload date:
  • Size: 99.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for agentgog-0.1.23.tar.gz
Algorithm Hash digest
SHA256 a2d5457638ffe110b7305dacc800abefbd30edeec9cda04546c9632d1a25722d
MD5 c2f9ab27b241e78dbfcf421e2e384c5f
BLAKE2b-256 68d0256641c38422c0eac71530b0ea04c0da82a9c294b5243c814454763288f6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentgog-0.1.23-py3-none-any.whl
  • Upload date:
  • Size: 76.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for agentgog-0.1.23-py3-none-any.whl
Algorithm Hash digest
SHA256 b1bf9af8285d491ca3e78b6259de62e382499f04e44f0fc2b3f89d9af61df9d3
MD5 96715a44bcf3ab17b6ae6b1b5c3a30e5
BLAKE2b-256 9df5c3f7ded1ac0b3edf842be693c5901ef98d7dce403bded440ae268f87bf14

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