Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/walkswithaswagger/whisperforge
WhisperForge is a Python tool that leverages OpenAI's Whisper model to transcribe large audio files. It automatically splits files into manageable chunks, processes them, and combines the transcriptions into a single document. Ideal for handling lengthy recordings and generating clear, organized transcriptions.
https://github.com/walkswithaswagger/whisperforge
audio-transcription openai python whisper
Last synced: about 2 months ago
JSON representation
WhisperForge is a Python tool that leverages OpenAI's Whisper model to transcribe large audio files. It automatically splits files into manageable chunks, processes them, and combines the transcriptions into a single document. Ideal for handling lengthy recordings and generating clear, organized transcriptions.
- Host: GitHub
- URL: https://github.com/walkswithaswagger/whisperforge
- Owner: WalksWithASwagger
- Created: 2024-08-15T18:20:11.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-11-17T17:48:19.000Z (about 2 months ago)
- Last Synced: 2024-11-17T18:38:42.945Z (about 2 months ago)
- Topics: audio-transcription, openai, python, whisper
- Language: Python
- Homepage: http://www.whisperforge.ai
- Size: 1.95 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
Awesome Lists containing this project
README
# WhisperForge
WhisperForge is an AI-powered audio transcription and analysis tool that integrates OpenAI's Whisper model with Notion for documentation.
## Features
- Audio file transcription (MP3, WAV, M4A, OGG)
- Automatic chunking of large audio files
- Language detection and support
- Direct export to Notion
- Insights extraction from transcribed content
## Prerequisites
- Python 3.11 (required for audioop support)
- ffmpeg
- OpenAI API key
- Notion API key and integration
## Installation
1. Create Python virtual environment:
```bash
python3.11 -m venv whisperforge-
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Install ffmpeg:
```bash
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt-get install ffmpeg
```
## Configuration
1. Create `.env` file with your API keys:
```env
OPENAI_API_KEY=your_openai_key_here
NOTION_API_KEY=your_notion_key_here
```
2. Set up Notion integration:
- Create a new integration at https://www.notion.so/my-integrations
- Share your target Notion page with the integration
## Usage
Run the Streamlit app:
```bash
streamlit run app.py
```
## Contributing
[Your contribution guidelines here]
## License
[Your chosen license here]
## Development Status
Currently implementing:
- Notion integration for permanent storage
- Monitoring and observability with Prometheus/Grafana
- Service health checks and logging