flock

Flock

AI-powered TikTok analytics manager for growing multiple accounts.

Stack

• Backend: Python + Flask
• Database: SQLite (data/flock.db)
• AI: Anthropic Claude API (claude-sonnet-4-20250514)
• Frontend: Vanilla HTML/CSS/JS (static/index.html)

Structure

• app.py: Flask routes and server
• database.py: SQLite setup and helpers
• analyzer.py: Claude API calls and prompt logic
• static/index.html: entire frontend, single file

Goals

• Track TikTok post performance across 2-5 accounts
• Generate AI insights on what content patterns work
• Daily growth recommendations for each account
• Eventually connect to TikTok Live API (Stage 2)

Conventions

• Keep frontend in a single index.html file until Stage 2
• All Claude prompts live in analyzer.py
• Never commit .env or data/ directory
• SQLite only until we need multi-user support