Skip to content

v0.1 — Initial release

Choose a tag to compare

View all tags
@NikolayS NikolayS released this 28 May 00:49
v0.1
79615c9

samoagent v0.1

CLI AI meeting agent. Joins Zoom/Google Meet calls via recall.ai, transcribes live using Deepgram Nova-3 (Russian + English mixed), and provides real-time context to an AI agent session.

Features

  • Join Zoom/Google Meet calls via recall.ai as a named bot (--name TARS)
  • Live transcription (Russian + English) via Deepgram Nova-3 with custom keyterm dictionaries for domain-specific vocabulary (e.g. postgresfm for PostgreSQL terminology)
  • Real-time transcript streaming via samoagent watch — designed for AI agent monitoring with the Monitor tool (persistent=true)
  • Meeting chat messages via samoagent chat — send messages into the call when needed
  • Live frame capture via RTMP pipeline: recall.ai streams mixed call video to a cloud VM running mediamtx, then samoagent frame grabs a live frame via ffmpeg
  • Auto-download of mediamtx binary on first use — no manual setup required
  • Bot avatar served via GitHub Pages (nikolays.github.io/samoagent) — animated robot with pulsing red recording indicator
  • State management in ~/.samoagent/ — bot_id, PIDs, webhook URL, and transcript path persisted across commands
  • CLAUDE.md agent workflow documentation — step-by-step instructions baked into the repo for AI agents joining calls

Commands

Command Description
samoagent join <url> Join a call and start the webhook server + ngrok tunnel
samoagent watch Stream live transcript to stdout
samoagent chat <message> Send a message into the meeting chat
samoagent frame Capture a live video frame (requires --rtmp-url)
samoagent screenshot Capture the local Mac screen
samoagent status Check bot status
samoagent transcript Read full post-call transcript from recall.ai
samoagent leave Remove bot, kill ngrok/server, clean up state
samoagent dicts List available keyword dictionaries

Setup

pip install -r requirements.txt
export RECALL_API_KEY=your_key
python3 samoagent join "https://zoom.us/j/123456" --name TARS --dict postgresfm

Requires: Python 3.9+, ngrok installed and authenticated, RECALL_API_KEY.

Assets 2
Loading