Getting Started with InsightHub Development
This guide will walk you through setting up the complete development environment for InsightHub, including both the backend and frontend.
Prerequisites
- Python 3.13 and Poetry
- Node.js 18+ and npm
- Git
Backend Setup
-
Clone the repository:
git clone <repository-url> cd insight_hub -
Install Python dependencies:
poetry install -
Set up environment variables:
You will need to set the following environment variables. You can do this by creating a
.envfile in the root of the project and adding the following lines:YOUTUBE_API=your_youtube_api_key OPENAI_API_KEY=your_openai_api_key TRANSCRIPTION_METHOD=openai # or 'local' for faster-whisper AUDIO_SPEED_FACTOR=2.0 # Optional: Factor to speed up audio for transcription -
Run the backend server:
poetry run streamlit run src/reddit_weekly_top/app.py
Frontend Setup
-
Navigate to the frontend directory:
cd insighthub-frontend -
Install Node.js dependencies:
npm install -
Run the frontend development server:
npm run dev
You should now have the backend running on http://localhost:8601 and the frontend on http://localhost:5173.