---
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
```bash
source venv/bin/activate
pip install -e .
export OPENAI_API_KEY=your_key_here
python -m ig_story_audit.main