README.md

metadata

title: Instagram Story Narrative Audit
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.1.0
app_file: app.py
pinned: false

Instagram Story Audit

A lightweight audit system to analyse Instagram Stories using OpenAI Vision, store semantic interpretations, and evaluate compliance against configurable policy rules.

What it does

• Reads Instagram Story images from disk
• Converts images into structured semantic descriptions using OpenAI
• Caches outputs to avoid repeated API calls
• Runs per-day audits (default: today, overridable via config)

Project structure

• data/raw_stories/ — input Story images
• data/vision_output/ — cached AI vision outputs (JSON)
• config/settings.ini — runtime configuration
• config/modes.ini — audit policy definitions

Running locally

source venv/bin/activate
pip install -e .
export OPENAI_API_KEY=your_key_here
python -m ig_story_audit.main