Getting Started

This guide will help you set up Morning Drive and generate your first briefing.

Prerequisites

Before you begin, ensure you have:

Python 3.11+ (for local development)
Docker & Docker Compose (recommended for deployment)
Node.js 18+ (for iOS app development)
Xcode (for iOS app building)

Required API Keys

Service	Purpose	Get Key
Anthropic	Claude AI for content generation	console.anthropic.com
ElevenLabs	Text-to-speech	elevenlabs.io

Note: Weather and news APIs are optional. Morning Drive uses free services (Open-Meteo for weather, RSS feeds for news) by default.

Step 1: Clone the Repository

git clone https://github.com/gkamer8/good-morning.git
cd good-morning

Step 2: Configure Environment

# Navigate to backend directory
cd backend

# Copy the environment template
cp .env.example .env

# Edit .env and add your API keys
nano .env

Required environment variables:

ANTHROPIC_API_KEY=sk-ant-...
ELEVENLABS_API_KEY=...
ADMIN_PASSWORD=your-secure-password

Step 3: Start the Server

docker-compose up -d

Running without Docker: See the Development guide for local Python setup without Docker.

Step 4: Verify Installation

# Check health endpoint
curl http://localhost:8000/health

# Expected response:
# {"status": "healthy", "service": "morning-drive"}

Step 5: Generate Your First Briefing

# Generate a briefing with default settings
curl -X POST http://localhost:8000/api/briefings/generate

# Check generation status
curl http://localhost:8000/api/briefings

Next Steps

Set up the iOS app to listen to your briefings
Configure production deployment
Customize user settings via the API

Morning Drive

Documentation