slurpai 0.1.0

Convert voice notes, videos, and audio files into AI-ready text and images

ingestible

Convert voice notes, videos, and audio files into AI-ready text and images.

Consultants, researchers, and anyone who works with AI tools faces the same problem: clients and colleagues send voice notes, screen recordings, and video walkthroughs — but your AI workflow needs text and images. Ingestible bridges that gap with a single command.

Quick start

pip install ingestible
export OPENAI_API_KEY=sk-...
ingest client-feedback.opus

That's it. You get a folder with transcript.txt and you're ready to feed it into whatever AI tool you're using.

Install

pip install ingestible

You also need ffmpeg on your PATH:

OS	Command
macOS	brew install ffmpeg
Ubuntu/Debian	sudo apt install ffmpeg
Windows	choco install ffmpeg or download from ffmpeg.org

Usage

# Transcribe a voice note
ingest recording.opus

# Process a video (transcript + frame grabs every 15 seconds)
ingest feedback.mp4

# Batch process everything in a folder
ingest *.opus *.mp4

# Grab frames more frequently
ingest --frame-interval 5 demo.mp4

# Use local Whisper instead of OpenAI API
pip install ingestible[local]
ingest --backend faster-whisper recording.opus

# Preview what would be processed
ingest --dry-run *.opus

Output

Each file produces a folder alongside it:

recording/
├── transcript.txt    # Plain text transcription
├── frames/           # Video frame grabs (video only)
│   ├── frame_001.jpg
│   ├── frame_002.jpg
│   └── ...
└── process.log       # Timestamped processing log

Re-running the same command skips already-completed files (idempotent).

Privacy notice

By default, ingestible sends your audio to OpenAI's Whisper API for transcription. Your audio is transmitted to OpenAI's servers. Review OpenAI's data usage policy to understand how your data is handled.

If you need fully local, private transcription — no data leaves your machine:

pip install ingestible[local]
ingest --backend faster-whisper recording.opus

This uses faster-whisper running entirely on your CPU. It's slower but nothing leaves your computer.

Configuration

Set OPENAI_API_KEY in your environment or a .env file in the current directory.

Variable	Default	Description
OPENAI_API_KEY	—	Required for OpenAI backend
INGESTIBLE_BACKEND	openai	Default backend (openai or faster-whisper)
OPENAI_WHISPER_MODEL	whisper-1	OpenAI model to use
INGESTIBLE_WHISPER_MODEL	base	Local Whisper model size (base, small, medium, large)

Supported formats

Audio: .opus, .m4a, .ogg, .mp3, .wav

Video: .mp4, .mkv, .mov, .webm

All formats are normalised to MP3 before transcription — this ensures consistent behaviour regardless of input format.

Requirements

• Python 3.10+
• ffmpeg on your PATH

Contributing

Found a bug or want to add a format? See CONTRIBUTING.md.

License

MIT