planopticon 0.2.0

AI-powered video analysis and knowledge extraction tool

PlanOpticon

AI-powered video analysis and knowledge extraction.

PlanOpticon processes video recordings into structured knowledge — transcripts, diagrams, action items, key points, and knowledge graphs. It auto-discovers available models across OpenAI, Anthropic, and Gemini, and produces rich multi-format output.

Features

• Multi-provider AI — Auto-discovers and routes to the best available model across OpenAI, Anthropic, and Google Gemini
• Smart frame extraction — Change detection for transitions + periodic capture for slow-evolving content (document scrolling, screen shares)
• People frame filtering — OpenCV face detection automatically removes webcam/video conference frames, keeping only shared content
• Diagram extraction — Vision model classification detects flowcharts, architecture diagrams, charts, and whiteboards
• Knowledge graphs — Extracts entities and relationships, builds and merges knowledge graphs across videos
• Action item detection — Finds commitments, tasks, and follow-ups with assignees and deadlines
• Batch processing — Process entire folders of videos with merged knowledge graphs and cross-referencing
• Rich output — Markdown, HTML, PDF reports. Mermaid diagrams, SVG/PNG renderings, JSON manifests
• Cloud sources — Fetch videos from Google Drive and Dropbox shared folders
• Checkpoint/resume — Pipeline resumes from where it left off if interrupted
• Screengrab fallback — When extraction isn't perfect, captures frames with captions — something is always better than nothing

Quick Start

# Install
pip install planopticon

# Analyze a single video
planopticon analyze -i meeting.mp4 -o ./output

# Process a folder of videos
planopticon batch -i ./recordings -o ./output --title "Weekly Meetings"

# See available AI models
planopticon list-models

Installation

From PyPI

pip install planopticon

# With all extras (PDF, cloud sources, GPU)
pip install planopticon[all]

From Source

git clone https://github.com/ConflictHQ/PlanOpticon.git
cd PlanOpticon
pip install -e ".[dev]"

Binary Download

Download standalone binaries (no Python required) from GitHub Releases.

Requirements

• Python 3.10+
• FFmpeg (brew install ffmpeg / apt install ffmpeg)
• At least one API key: OPENAI_API_KEY, ANTHROPIC_API_KEY, or GEMINI_API_KEY

Output Structure

output/
├── manifest.json              # Single source of truth
├── transcript/
│   ├── transcript.json        # Full transcript with timestamps
│   ├── transcript.txt         # Plain text
│   └── transcript.srt         # Subtitles
├── frames/                    # Content frames (people filtered out)
├── diagrams/                  # Detected diagrams + mermaid code
├── captures/                  # Screengrab fallbacks
└── results/
    ├── analysis.md            # Markdown report
    ├── analysis.html          # HTML report
    ├── analysis.pdf           # PDF report
    ├── knowledge_graph.json   # Entities and relationships
    ├── key_points.json        # Extracted key points
    └── action_items.json      # Tasks and follow-ups

Processing Depth

Depth	What you get
basic	Transcription, key points, action items
standard	+ Diagram extraction (10 frames), knowledge graph, full reports
comprehensive	+ More frames analyzed (20), deeper extraction

Documentation

Full documentation at planopticon.dev

License

MIT License — Copyright (c) 2026 CONFLICT LLC