brainstem-agents

Three agents for RAPP Brainstem — Kody Wildfeuer's local-first AI agent server.

These are the agents I (Vic) wrote while playing with brainstem. Preserved here so the work isn't tied to a single local checkout.

What's here

Agent	What it does	Deps
meeting_notes_agent.py	Pure prompt template — takes a transcript, returns a structured-notes prompt for the LLM to fill in (summary, key points, action items, decisions, open questions).	None
screen_capture_agent.py	Grabs a screenshot via PIL.ImageGrab, saves to disk, returns the path. Useful for visual context during meetings.	Pillow
transcription_agent.py	Records mic audio with sounddevice, saves WAV, transcribes locally with OpenAI Whisper. start / stop / status actions.	sounddevice, soundfile, numpy, openai-whisper

The three are designed to work together: screen_capture for visuals, transcription for audio → text, meeting_notes to turn the transcript into something sendable.

Install into a brainstem

# Assuming brainstem is cloned per https://github.com/kody-w/rapp-installer
cp *.py ~/.brainstem/src/rapp_brainstem/agents/

# For transcription_agent (heavy deps):
pip install sounddevice soundfile numpy openai-whisper

# For screen_capture_agent:
pip install Pillow

Brainstem auto-discovers *_agent.py in agents/ — no restart needed. Each class extends BasicAgent and exposes a perform(**kwargs) method.

Related

The meeting_notes prompt template is also available as a markdown skill (no brainstem required) in the digital-twin plugin under .github/skills/meeting-notes/. Use the skill version if you don't want to run a server.

License

MIT.