https://github.com/vbshuliar/knowcast-ai
Turns PDFs into podcasts with AI.
https://github.com/vbshuliar/knowcast-ai
cloud cursor elevenlabs hackathon lovable openai veed
Last synced: 14 days ago
JSON representation
Turns PDFs into podcasts with AI.
- Host: GitHub
- URL: https://github.com/vbshuliar/knowcast-ai
- Owner: vbshuliar
- Created: 2025-11-22T10:27:47.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-11-22T14:51:56.000Z (7 months ago)
- Last Synced: 2025-11-22T15:21:50.977Z (7 months ago)
- Topics: cloud, cursor, elevenlabs, hackathon, lovable, openai, veed
- Language: Python
- Homepage:
- Size: 13.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KnowCast AI 🎙️
Transform any topic into engaging podcast conversations using AI. Ask about anything - knowledge, news, current events, and more.
## Quick Setup
### 1. Install Dependencies
```bash
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
```
### 2. Add API Keys
Create a `.env` file in the project root:
```bash
VALYU_API_KEY=your_valyu_key_here
OPENAI_API_KEY=your_openai_key_here
ELEVENLABS_API_KEY=your_elevenlabs_key_here
```
### 3. Run the Application
```bash
./scripts/start.sh
```
Or manually:
```bash
source venv/bin/activate
python -m src.api
```
### 4. Open the Web Interface
Open `frontend/index.html` in your browser.
## How It Works
1. **Enter any query** (e.g., "What's happening with AI regulation?", "Explain quantum computing", "Latest news on climate change")
2. **Click "Extract Knowledge"** - Searches the internet and extracts comprehensive information
3. **Click "Generate Podcast"** - Creates a multi-speaker audio conversation
## Project Structure
```
knowcast-ai/
├── src/ # Main application code
├── tests/ # Test files
├── scripts/ # Utility scripts
├── frontend/ # Web interface
└── podcasts/ # Generated audio files
```
## API Endpoints
- `GET /api/health` - Check API status
- `POST /api/extract` - Extract knowledge from query
- `POST /api/generate-podcast` - Generate complete podcast
## Testing
```bash
# Test knowledge extraction
python -m src.knowledge_extraction
# Test API
python tests/test_api.py
```
## Troubleshooting
**Module not found?**
```bash
source venv/bin/activate
pip install -r requirements.txt
```
**Port 5001 already in use?**
```bash
lsof -i :5001 # Find process
# Kill it or change port in src/api.py
```
**API key errors?**
- Make sure `.env` file exists in project root
- No quotes around keys: `KEY=value` not `KEY="value"`
- No spaces around `=`
---
**Ask anything, learn everything** 🚀