PlanOpticon

planopticon / docs / index.md
Source Blame History 92 lines
f0106a3… leo 1 # PlanOpticon
f0106a3… leo 2
0981a08… noreply 3 **AI-powered video analysis, knowledge extraction, and planning.**
f0106a3… leo 4
0981a08… noreply 5 PlanOpticon processes video recordings and documents into structured knowledge — transcripts, diagrams, action items, key points, and knowledge graphs. It connects to 20+ source platforms, auto-discovers available models across multiple AI providers, and produces rich multi-format output with an interactive companion REPL and planning agent.
f0106a3… leo 6
f0106a3… leo 7 ---
f0106a3… leo 8
f0106a3… leo 9 ## Features
f0106a3… leo 10
0981a08… noreply 11 - **Multi-provider AI** — Automatically discovers and routes to the best available model across OpenAI, Anthropic, Google Gemini, and more
0981a08… noreply 12 - **Planning agent** — Agentic analysis that adaptively adjusts depth, focus, and strategy based on content
0981a08… noreply 13 - **Companion REPL** — Interactive chat interface for exploring your knowledge base conversationally
0981a08… noreply 14 - **20+ source connectors** — Google Workspace, Microsoft 365, Zoom, Teams, Meet, Notion, GitHub, YouTube, Obsidian, Apple Notes, and more
0981a08… noreply 15 - **Document export** — Export knowledge to Markdown, Obsidian, Notion, and exchange formats
0981a08… noreply 16 - **OAuth authentication** — Built-in `planopticon auth` for Google, Dropbox, Zoom, Notion, GitHub, and Microsoft
ecf907c… leo 17 - **Smart frame extraction** — Change detection for transitions + periodic capture (every 30s) for slow-evolving content like document scrolling
ecf907c… leo 18 - **People frame filtering** — OpenCV face detection removes webcam/video conference frames, keeping only shared content (slides, documents, screen shares)
f0106a3… leo 19 - **Diagram extraction** — Vision model-based classification detects flowcharts, architecture diagrams, charts, and whiteboards
f0106a3… leo 20 - **Knowledge graphs** — Extracts entities and relationships, builds and merges knowledge graphs across videos
f0106a3… leo 21 - **Action item detection** — Finds commitments, tasks, and follow-ups with assignees and deadlines
f0106a3… leo 22 - **Batch processing** — Process entire folders of videos with merged knowledge graphs and cross-referencing
f0106a3… leo 23 - **Rich output** — Markdown, HTML, PDF, Mermaid diagrams, SVG/PNG renderings, JSON manifests
0981a08… noreply 24 - **Cloud sources** — Fetch videos from Google Drive, Dropbox, and many more cloud platforms
ecf907c… leo 25 - **Checkpoint/resume** — Pipeline resumes from where it left off if interrupted — no wasted work
f0106a3… leo 26 - **Screengrab fallback** — When extraction isn't perfect, captures frames with captions — something is always better than nothing
f0106a3… leo 27
f0106a3… leo 28 ## Quick Start
f0106a3… leo 29
f0106a3… leo 30 ```bash
f0106a3… leo 31 # Install from PyPI
f0106a3… leo 32 pip install planopticon
f0106a3… leo 33
f0106a3… leo 34 # Analyze a single video
f0106a3… leo 35 planopticon analyze -i meeting.mp4 -o ./output
0981a08… noreply 36
0981a08… noreply 37 # Ingest documents and build a knowledge graph
0981a08… noreply 38 planopticon ingest ./notes/ --output ./kb --recursive
0981a08… noreply 39
0981a08… noreply 40 # Chat with your knowledge base
0981a08… noreply 41 planopticon companion --kb ./kb
0981a08… noreply 42
0981a08… noreply 43 # Run the planning agent interactively
0981a08… noreply 44 planopticon agent --kb ./kb --interactive
0981a08… noreply 45
0981a08… noreply 46 # Query the knowledge graph
0981a08… noreply 47 planopticon query stats
0981a08… noreply 48
0981a08… noreply 49 # Export to Obsidian
0981a08… noreply 50 planopticon export obsidian --input ./kb --output ./vault
f0106a3… leo 51
f0106a3… leo 52 # Process a folder of videos
f0106a3… leo 53 planopticon batch -i ./recordings -o ./output --title "Weekly Meetings"
f0106a3… leo 54
f0106a3… leo 55 # See available AI models
f0106a3… leo 56 planopticon list-models
f0106a3… leo 57 ```
f0106a3… leo 58
f0106a3… leo 59 ## Installation
f0106a3… leo 60
f0106a3… leo 61 === "PyPI (Recommended)"
f0106a3… leo 62
f0106a3… leo 63 ```bash
f0106a3… leo 64 pip install planopticon
f0106a3… leo 65 ```
f0106a3… leo 66
f0106a3… leo 67 === "With cloud sources"
f0106a3… leo 68
f0106a3… leo 69 ```bash
f0106a3… leo 70 pip install planopticon[cloud]
f0106a3… leo 71 ```
f0106a3… leo 72
f0106a3… leo 73 === "With everything"
f0106a3… leo 74
f0106a3… leo 75 ```bash
f0106a3… leo 76 pip install planopticon[all]
f0106a3… leo 77 ```
f0106a3… leo 78
f0106a3… leo 79 === "Binary (no Python needed)"
f0106a3… leo 80
f0106a3… leo 81 Download the latest binary for your platform from
ecf907c… leo 82 [GitHub Releases](https://github.com/ConflictHQ/PlanOpticon/releases).
f0106a3… leo 83
f0106a3… leo 84 ## Requirements
f0106a3… leo 85
f0106a3… leo 86 - Python 3.10+
f0106a3… leo 87 - FFmpeg (for audio extraction)
f0106a3… leo 88 - At least one API key: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `GEMINI_API_KEY`
f0106a3… leo 89
f0106a3… leo 90 ## License
f0106a3… leo 91
ecf907c… leo 92 MIT License — Copyright (c) 2026 CONFLICT LLC. All rights reserved.

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button