PlanOpticon

planopticon / faq / index.html
Source Rendered
Blame History Raw 2685 lines
1
2
<!doctype html>
3
<html lang="en" class="no-js">
4
<head>
5
6
<meta charset="utf-8">
7
<meta name="viewport" content="width=device-width,initial-scale=1">
8
9
<meta name="description" content="AI-powered video analysis and knowledge extraction">
10
11
12
<meta name="author" content="CONFLICT LLC">
13
14
15
<link rel="canonical" href="https://planopticon.dev/faq/">
16
17
18
<link rel="prev" href="../api/auth/">
19
20
21
<link rel="next" href="../contributing/">
22
23
24
25
26
27
<link rel="icon" href="../assets/images/favicon.png">
28
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.4">
29
30
31
32
<title>FAQ & Troubleshooting - PlanOpticon</title>
33
34
35
36
<link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
37
38
39
<link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
40
41
42
43
44
45
46
47
48
49
50
51
52
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
56
57
58
<link rel="stylesheet" href="../assets/_mkdocstrings.css">
59
60
<link rel="stylesheet" href="../assets/css/custom.css">
61
62
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
63
64
65
66
67
68
</head>
69
70
71
72
73
74
75
76
77
78
<body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
79
80
81
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
82
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
83
<label class="md-overlay" for="__drawer"></label>
84
<div data-md-component="skip">
85
86
87
<a href="#faq-troubleshooting" class="md-skip">
88
Skip to content
89
</a>
90
91
</div>
92
<div data-md-component="announce">
93
94
</div>
95
96
97
98
99
<header class="md-header" data-md-component="header">
100
<nav class="md-header__inner md-grid" aria-label="Header">
101
<a href=".." title="PlanOpticon" class="md-header__button md-logo" aria-label="PlanOpticon" data-md-component="logo">
102
103
<img src="../assets/images/conflict-logo.svg" alt="logo">
104
105
</a>
106
<label class="md-header__button md-icon" for="__drawer">
107
108
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
109
</label>
110
<div class="md-header__title" data-md-component="header-title">
111
<div class="md-header__ellipsis">
112
<div class="md-header__topic">
113
<span class="md-ellipsis">
114
PlanOpticon
115
</span>
116
</div>
117
<div class="md-header__topic" data-md-component="header-topic">
118
<span class="md-ellipsis">
119
120
FAQ & Troubleshooting
121
122
</span>
123
</div>
124
</div>
125
</div>
126
127
128
<form class="md-header__option" data-md-component="palette">
129
130
131
132
133
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
134
135
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
136
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
137
</label>
138
139
140
141
142
143
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
144
145
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
146
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
147
</label>
148
149
150
</form>
151
152
153
154
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
155
156
157
158
159
160
<label class="md-header__button md-icon" for="__search">
161
162
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
163
</label>
164
<div class="md-search" data-md-component="search" role="dialog">
165
<label class="md-search__overlay" for="__search"></label>
166
<div class="md-search__inner" role="search">
167
<form class="md-search__form" name="search">
168
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
169
<label class="md-search__icon md-icon" for="__search">
170
171
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
172
173
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
174
</label>
175
<nav class="md-search__options" aria-label="Search">
176
177
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
178
179
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
180
</button>
181
</nav>
182
183
<div class="md-search__suggest" data-md-component="search-suggest"></div>
184
185
</form>
186
<div class="md-search__output">
187
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
188
<div class="md-search-result" data-md-component="search-result">
189
<div class="md-search-result__meta">
190
Initializing search
191
</div>
192
<ol class="md-search-result__list" role="presentation"></ol>
193
</div>
194
</div>
195
</div>
196
</div>
197
</div>
198
199
200
201
<div class="md-header__source">
202
<a href="https://github.com/ConflictHQ/PlanOpticon" title="Go to repository" class="md-source" data-md-component="source">
203
<div class="md-source__icon md-icon">
204
205
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
206
</div>
207
<div class="md-source__repository">
208
ConflictHQ/PlanOpticon
209
</div>
210
</a>
211
</div>
212
213
</nav>
214
215
</header>
216
217
<div class="md-container" data-md-component="container">
218
219
220
221
222
223
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
224
<div class="md-grid">
225
<ul class="md-tabs__list">
226
227
228
229
230
231
232
<li class="md-tabs__item">
233
<a href=".." class="md-tabs__link">
234
235
236
237
238
239
Home
240
241
</a>
242
</li>
243
244
245
246
247
248
249
250
251
252
253
<li class="md-tabs__item">
254
<a href="../getting-started/installation/" class="md-tabs__link">
255
256
257
258
Getting Started
259
260
</a>
261
</li>
262
263
264
265
266
267
268
269
270
271
272
273
<li class="md-tabs__item">
274
<a href="../guide/single-video/" class="md-tabs__link">
275
276
277
278
User Guide
279
280
</a>
281
</li>
282
283
284
285
286
287
288
289
290
291
<li class="md-tabs__item">
292
<a href="../use-cases/" class="md-tabs__link">
293
294
295
296
297
298
Use Cases
299
300
</a>
301
</li>
302
303
304
305
306
307
308
309
310
<li class="md-tabs__item">
311
<a href="../cli-reference/" class="md-tabs__link">
312
313
314
315
316
317
CLI Reference
318
319
</a>
320
</li>
321
322
323
324
325
326
327
328
329
330
331
<li class="md-tabs__item">
332
<a href="../architecture/overview/" class="md-tabs__link">
333
334
335
336
Architecture
337
338
</a>
339
</li>
340
341
342
343
344
345
346
347
348
349
350
351
<li class="md-tabs__item">
352
<a href="../api/models/" class="md-tabs__link">
353
354
355
356
API Reference
357
358
</a>
359
</li>
360
361
362
363
364
365
366
367
368
369
370
371
<li class="md-tabs__item md-tabs__item--active">
372
<a href="./" class="md-tabs__link">
373
374
375
376
377
378
FAQ & Troubleshooting
379
380
</a>
381
</li>
382
383
384
385
386
387
388
389
390
<li class="md-tabs__item">
391
<a href="../contributing/" class="md-tabs__link">
392
393
394
395
396
397
Contributing
398
399
</a>
400
</li>
401
402
403
404
</ul>
405
</div>
406
</nav>
407
408
409
410
<main class="md-main" data-md-component="main">
411
<div class="md-main__inner md-grid">
412
413
414
415
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
416
<div class="md-sidebar__scrollwrap">
417
<div class="md-sidebar__inner">
418
419
420
421
422
423
424
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
425
<label class="md-nav__title" for="__drawer">
426
<a href=".." title="PlanOpticon" class="md-nav__button md-logo" aria-label="PlanOpticon" data-md-component="logo">
427
428
<img src="../assets/images/conflict-logo.svg" alt="logo">
429
430
</a>
431
PlanOpticon
432
</label>
433
434
<div class="md-nav__source">
435
<a href="https://github.com/ConflictHQ/PlanOpticon" title="Go to repository" class="md-source" data-md-component="source">
436
<div class="md-source__icon md-icon">
437
438
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
439
</div>
440
<div class="md-source__repository">
441
ConflictHQ/PlanOpticon
442
</div>
443
</a>
444
</div>
445
446
<ul class="md-nav__list" data-md-scrollfix>
447
448
449
450
451
452
453
454
<li class="md-nav__item">
455
<a href=".." class="md-nav__link">
456
457
458
459
<span class="md-ellipsis">
460
461
462
Home
463
464
465
466
</span>
467
468
469
470
</a>
471
</li>
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
<li class="md-nav__item md-nav__item--nested">
492
493
494
495
496
497
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
498
499
500
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
501
502
503
504
<span class="md-ellipsis">
505
506
507
Getting Started
508
509
510
511
</span>
512
513
514
515
<span class="md-nav__icon md-icon"></span>
516
</label>
517
518
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
519
<label class="md-nav__title" for="__nav_2">
520
<span class="md-nav__icon md-icon"></span>
521
522
523
Getting Started
524
525
526
</label>
527
<ul class="md-nav__list" data-md-scrollfix>
528
529
530
531
532
533
534
535
<li class="md-nav__item">
536
<a href="../getting-started/installation/" class="md-nav__link">
537
538
539
540
<span class="md-ellipsis">
541
542
543
Installation
544
545
546
547
</span>
548
549
550
551
</a>
552
</li>
553
554
555
556
557
558
559
560
561
562
563
<li class="md-nav__item">
564
<a href="../getting-started/quickstart/" class="md-nav__link">
565
566
567
568
<span class="md-ellipsis">
569
570
571
Quick Start
572
573
574
575
</span>
576
577
578
579
</a>
580
</li>
581
582
583
584
585
586
587
588
589
590
591
<li class="md-nav__item">
592
<a href="../getting-started/configuration/" class="md-nav__link">
593
594
595
596
<span class="md-ellipsis">
597
598
599
Configuration
600
601
602
603
</span>
604
605
606
607
</a>
608
</li>
609
610
611
612
613
</ul>
614
</nav>
615
616
</li>
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
<li class="md-nav__item md-nav__item--nested">
637
638
639
640
641
642
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
643
644
645
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
646
647
648
649
<span class="md-ellipsis">
650
651
652
User Guide
653
654
655
656
</span>
657
658
659
660
<span class="md-nav__icon md-icon"></span>
661
</label>
662
663
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
664
<label class="md-nav__title" for="__nav_3">
665
<span class="md-nav__icon md-icon"></span>
666
667
668
User Guide
669
670
671
</label>
672
<ul class="md-nav__list" data-md-scrollfix>
673
674
675
676
677
678
679
680
<li class="md-nav__item">
681
<a href="../guide/single-video/" class="md-nav__link">
682
683
684
685
<span class="md-ellipsis">
686
687
688
Single Video Analysis
689
690
691
692
</span>
693
694
695
696
</a>
697
</li>
698
699
700
701
702
703
704
705
706
707
708
<li class="md-nav__item">
709
<a href="../guide/batch/" class="md-nav__link">
710
711
712
713
<span class="md-ellipsis">
714
715
716
Batch Processing
717
718
719
720
</span>
721
722
723
724
</a>
725
</li>
726
727
728
729
730
731
732
733
734
735
736
<li class="md-nav__item">
737
<a href="../guide/document-ingestion/" class="md-nav__link">
738
739
740
741
<span class="md-ellipsis">
742
743
744
Document Ingestion
745
746
747
748
</span>
749
750
751
752
</a>
753
</li>
754
755
756
757
758
759
760
761
762
763
764
<li class="md-nav__item">
765
<a href="../guide/cloud-sources/" class="md-nav__link">
766
767
768
769
<span class="md-ellipsis">
770
771
772
Cloud Sources
773
774
775
776
</span>
777
778
779
780
</a>
781
</li>
782
783
784
785
786
787
788
789
790
791
792
<li class="md-nav__item">
793
<a href="../guide/knowledge-graphs/" class="md-nav__link">
794
795
796
797
<span class="md-ellipsis">
798
799
800
Knowledge Graphs
801
802
803
804
</span>
805
806
807
808
</a>
809
</li>
810
811
812
813
814
815
816
817
818
819
820
<li class="md-nav__item">
821
<a href="../guide/companion/" class="md-nav__link">
822
823
824
825
<span class="md-ellipsis">
826
827
828
Interactive Companion
829
830
831
832
</span>
833
834
835
836
</a>
837
</li>
838
839
840
841
842
843
844
845
846
847
848
<li class="md-nav__item">
849
<a href="../guide/planning-agent/" class="md-nav__link">
850
851
852
853
<span class="md-ellipsis">
854
855
856
Planning Agent
857
858
859
860
</span>
861
862
863
864
</a>
865
</li>
866
867
868
869
870
871
872
873
874
875
876
<li class="md-nav__item">
877
<a href="../guide/authentication/" class="md-nav__link">
878
879
880
881
<span class="md-ellipsis">
882
883
884
Authentication
885
886
887
888
</span>
889
890
891
892
</a>
893
</li>
894
895
896
897
898
899
900
901
902
903
904
<li class="md-nav__item">
905
<a href="../guide/export/" class="md-nav__link">
906
907
908
909
<span class="md-ellipsis">
910
911
912
Export & Documents
913
914
915
916
</span>
917
918
919
920
</a>
921
</li>
922
923
924
925
926
927
928
929
930
931
932
<li class="md-nav__item">
933
<a href="../guide/output-formats/" class="md-nav__link">
934
935
936
937
<span class="md-ellipsis">
938
939
940
Output Formats
941
942
943
944
</span>
945
946
947
948
</a>
949
</li>
950
951
952
953
954
</ul>
955
</nav>
956
957
</li>
958
959
960
961
962
963
964
965
966
967
<li class="md-nav__item">
968
<a href="../use-cases/" class="md-nav__link">
969
970
971
972
<span class="md-ellipsis">
973
974
975
Use Cases
976
977
978
979
</span>
980
981
982
983
</a>
984
</li>
985
986
987
988
989
990
991
992
993
994
<li class="md-nav__item">
995
<a href="../cli-reference/" class="md-nav__link">
996
997
998
999
<span class="md-ellipsis">
1000
1001
1002
CLI Reference
1003
1004
1005
1006
</span>
1007
1008
1009
1010
</a>
1011
</li>
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
<li class="md-nav__item md-nav__item--nested">
1032
1033
1034
1035
1036
1037
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
1038
1039
1040
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
1041
1042
1043
1044
<span class="md-ellipsis">
1045
1046
1047
Architecture
1048
1049
1050
1051
</span>
1052
1053
1054
1055
<span class="md-nav__icon md-icon"></span>
1056
</label>
1057
1058
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
1059
<label class="md-nav__title" for="__nav_6">
1060
<span class="md-nav__icon md-icon"></span>
1061
1062
1063
Architecture
1064
1065
1066
</label>
1067
<ul class="md-nav__list" data-md-scrollfix>
1068
1069
1070
1071
1072
1073
1074
1075
<li class="md-nav__item">
1076
<a href="../architecture/overview/" class="md-nav__link">
1077
1078
1079
1080
<span class="md-ellipsis">
1081
1082
1083
Overview
1084
1085
1086
1087
</span>
1088
1089
1090
1091
</a>
1092
</li>
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
<li class="md-nav__item">
1104
<a href="../architecture/providers/" class="md-nav__link">
1105
1106
1107
1108
<span class="md-ellipsis">
1109
1110
1111
Provider System
1112
1113
1114
1115
</span>
1116
1117
1118
1119
</a>
1120
</li>
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
<li class="md-nav__item">
1132
<a href="../architecture/pipeline/" class="md-nav__link">
1133
1134
1135
1136
<span class="md-ellipsis">
1137
1138
1139
Processing Pipeline
1140
1141
1142
1143
</span>
1144
1145
1146
1147
</a>
1148
</li>
1149
1150
1151
1152
1153
</ul>
1154
</nav>
1155
1156
</li>
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
<li class="md-nav__item md-nav__item--nested">
1177
1178
1179
1180
1181
1182
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_7" >
1183
1184
1185
<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
1186
1187
1188
1189
<span class="md-ellipsis">
1190
1191
1192
API Reference
1193
1194
1195
1196
</span>
1197
1198
1199
1200
<span class="md-nav__icon md-icon"></span>
1201
</label>
1202
1203
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
1204
<label class="md-nav__title" for="__nav_7">
1205
<span class="md-nav__icon md-icon"></span>
1206
1207
1208
API Reference
1209
1210
1211
</label>
1212
<ul class="md-nav__list" data-md-scrollfix>
1213
1214
1215
1216
1217
1218
1219
1220
<li class="md-nav__item">
1221
<a href="../api/models/" class="md-nav__link">
1222
1223
1224
1225
<span class="md-ellipsis">
1226
1227
1228
Models
1229
1230
1231
1232
</span>
1233
1234
1235
1236
</a>
1237
</li>
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
<li class="md-nav__item">
1249
<a href="../api/providers/" class="md-nav__link">
1250
1251
1252
1253
<span class="md-ellipsis">
1254
1255
1256
Providers
1257
1258
1259
1260
</span>
1261
1262
1263
1264
</a>
1265
</li>
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
<li class="md-nav__item">
1277
<a href="../api/analyzers/" class="md-nav__link">
1278
1279
1280
1281
<span class="md-ellipsis">
1282
1283
1284
Analyzers
1285
1286
1287
1288
</span>
1289
1290
1291
1292
</a>
1293
</li>
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
<li class="md-nav__item">
1305
<a href="../api/agent/" class="md-nav__link">
1306
1307
1308
1309
<span class="md-ellipsis">
1310
1311
1312
Agent & Skills
1313
1314
1315
1316
</span>
1317
1318
1319
1320
</a>
1321
</li>
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
<li class="md-nav__item">
1333
<a href="../api/sources/" class="md-nav__link">
1334
1335
1336
1337
<span class="md-ellipsis">
1338
1339
1340
Sources
1341
1342
1343
1344
</span>
1345
1346
1347
1348
</a>
1349
</li>
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
<li class="md-nav__item">
1361
<a href="../api/auth/" class="md-nav__link">
1362
1363
1364
1365
<span class="md-ellipsis">
1366
1367
1368
Authentication
1369
1370
1371
1372
</span>
1373
1374
1375
1376
</a>
1377
</li>
1378
1379
1380
1381
1382
</ul>
1383
</nav>
1384
1385
</li>
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
<li class="md-nav__item md-nav__item--active">
1398
1399
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
1400
1401
1402
1403
1404
1405
<label class="md-nav__link md-nav__link--active" for="__toc">
1406
1407
1408
1409
<span class="md-ellipsis">
1410
1411
1412
FAQ & Troubleshooting
1413
1414
1415
1416
</span>
1417
1418
1419
1420
<span class="md-nav__icon md-icon"></span>
1421
</label>
1422
1423
<a href="./" class="md-nav__link md-nav__link--active">
1424
1425
1426
1427
<span class="md-ellipsis">
1428
1429
1430
FAQ & Troubleshooting
1431
1432
1433
1434
</span>
1435
1436
1437
1438
</a>
1439
1440
1441
1442
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1443
1444
1445
1446
1447
1448
1449
<label class="md-nav__title" for="__toc">
1450
<span class="md-nav__icon md-icon"></span>
1451
Table of contents
1452
</label>
1453
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1454
1455
<li class="md-nav__item">
1456
<a href="#frequently-asked-questions" class="md-nav__link">
1457
<span class="md-ellipsis">
1458
1459
Frequently Asked Questions
1460
1461
</span>
1462
</a>
1463
1464
<nav class="md-nav" aria-label="Frequently Asked Questions">
1465
<ul class="md-nav__list">
1466
1467
<li class="md-nav__item">
1468
<a href="#do-i-need-an-api-key" class="md-nav__link">
1469
<span class="md-ellipsis">
1470
1471
Do I need an API key?
1472
1473
</span>
1474
</a>
1475
1476
</li>
1477
1478
<li class="md-nav__item">
1479
<a href="#how-much-does-it-cost" class="md-nav__link">
1480
<span class="md-ellipsis">
1481
1482
How much does it cost?
1483
1484
</span>
1485
</a>
1486
1487
</li>
1488
1489
<li class="md-nav__item">
1490
<a href="#can-i-run-fully-offline" class="md-nav__link">
1491
<span class="md-ellipsis">
1492
1493
Can I run fully offline?
1494
1495
</span>
1496
</a>
1497
1498
</li>
1499
1500
<li class="md-nav__item">
1501
<a href="#what-video-formats-are-supported" class="md-nav__link">
1502
<span class="md-ellipsis">
1503
1504
What video formats are supported?
1505
1506
</span>
1507
</a>
1508
1509
</li>
1510
1511
<li class="md-nav__item">
1512
<a href="#what-document-formats-can-i-ingest" class="md-nav__link">
1513
<span class="md-ellipsis">
1514
1515
What document formats can I ingest?
1516
1517
</span>
1518
</a>
1519
1520
</li>
1521
1522
<li class="md-nav__item">
1523
<a href="#how-does-the-knowledge-graph-work" class="md-nav__link">
1524
<span class="md-ellipsis">
1525
1526
How does the knowledge graph work?
1527
1528
</span>
1529
</a>
1530
1531
</li>
1532
1533
<li class="md-nav__item">
1534
<a href="#can-i-use-planopticon-with-my-existing-obsidian-vault" class="md-nav__link">
1535
<span class="md-ellipsis">
1536
1537
Can I use PlanOpticon with my existing Obsidian vault?
1538
1539
</span>
1540
</a>
1541
1542
</li>
1543
1544
<li class="md-nav__item">
1545
<a href="#how-do-i-add-my-own-ai-provider" class="md-nav__link">
1546
<span class="md-ellipsis">
1547
1548
How do I add my own AI provider?
1549
1550
</span>
1551
</a>
1552
1553
</li>
1554
1555
</ul>
1556
</nav>
1557
1558
</li>
1559
1560
<li class="md-nav__item">
1561
<a href="#troubleshooting" class="md-nav__link">
1562
<span class="md-ellipsis">
1563
1564
Troubleshooting
1565
1566
</span>
1567
</a>
1568
1569
<nav class="md-nav" aria-label="Troubleshooting">
1570
<ul class="md-nav__list">
1571
1572
<li class="md-nav__item">
1573
<a href="#authentication-errors" class="md-nav__link">
1574
<span class="md-ellipsis">
1575
1576
Authentication errors
1577
1578
</span>
1579
</a>
1580
1581
<nav class="md-nav" aria-label="Authentication errors">
1582
<ul class="md-nav__list">
1583
1584
<li class="md-nav__item">
1585
<a href="#no-auth-method-available-for-zoom" class="md-nav__link">
1586
<span class="md-ellipsis">
1587
1588
"No auth method available for zoom"
1589
1590
</span>
1591
</a>
1592
1593
</li>
1594
1595
<li class="md-nav__item">
1596
<a href="#token-expired-or-401-unauthorized" class="md-nav__link">
1597
<span class="md-ellipsis">
1598
1599
"Token expired" or "401 Unauthorized"
1600
1601
</span>
1602
</a>
1603
1604
</li>
1605
1606
<li class="md-nav__item">
1607
<a href="#oauth-redirect-errors" class="md-nav__link">
1608
<span class="md-ellipsis">
1609
1610
OAuth redirect errors
1611
1612
</span>
1613
</a>
1614
1615
</li>
1616
1617
</ul>
1618
</nav>
1619
1620
</li>
1621
1622
<li class="md-nav__item">
1623
<a href="#provider-errors" class="md-nav__link">
1624
<span class="md-ellipsis">
1625
1626
Provider errors
1627
1628
</span>
1629
</a>
1630
1631
<nav class="md-nav" aria-label="Provider errors">
1632
<ul class="md-nav__list">
1633
1634
<li class="md-nav__item">
1635
<a href="#anthropic_api_key-not-set" class="md-nav__link">
1636
<span class="md-ellipsis">
1637
1638
"ANTHROPIC_API_KEY not set"
1639
1640
</span>
1641
</a>
1642
1643
</li>
1644
1645
<li class="md-nav__item">
1646
<a href="#unexpected-role-system-anthropic" class="md-nav__link">
1647
<span class="md-ellipsis">
1648
1649
"Unexpected role system" (Anthropic)
1650
1651
</span>
1652
</a>
1653
1654
</li>
1655
1656
<li class="md-nav__item">
1657
<a href="#model-not-found-or-invalid-model" class="md-nav__link">
1658
<span class="md-ellipsis">
1659
1660
"Model not found" or "Invalid model"
1661
1662
</span>
1663
</a>
1664
1665
</li>
1666
1667
<li class="md-nav__item">
1668
<a href="#rate-limiting-429-errors" class="md-nav__link">
1669
<span class="md-ellipsis">
1670
1671
Rate limiting / 429 errors
1672
1673
</span>
1674
</a>
1675
1676
</li>
1677
1678
</ul>
1679
</nav>
1680
1681
</li>
1682
1683
<li class="md-nav__item">
1684
<a href="#processing-errors" class="md-nav__link">
1685
<span class="md-ellipsis">
1686
1687
Processing errors
1688
1689
</span>
1690
</a>
1691
1692
<nav class="md-nav" aria-label="Processing errors">
1693
<ul class="md-nav__list">
1694
1695
<li class="md-nav__item">
1696
<a href="#ffmpeg-not-found" class="md-nav__link">
1697
<span class="md-ellipsis">
1698
1699
"FFmpeg not found"
1700
1701
</span>
1702
</a>
1703
1704
</li>
1705
1706
<li class="md-nav__item">
1707
<a href="#audio-extraction-failed-no-audio-track-found" class="md-nav__link">
1708
<span class="md-ellipsis">
1709
1710
"Audio extraction failed: no audio track found"
1711
1712
</span>
1713
</a>
1714
1715
</li>
1716
1717
<li class="md-nav__item">
1718
<a href="#frame-extraction-memory-error" class="md-nav__link">
1719
<span class="md-ellipsis">
1720
1721
"Frame extraction memory error"
1722
1723
</span>
1724
</a>
1725
1726
</li>
1727
1728
<li class="md-nav__item">
1729
<a href="#batch-processing-one-video-fails" class="md-nav__link">
1730
<span class="md-ellipsis">
1731
1732
Batch processing — one video fails
1733
1734
</span>
1735
</a>
1736
1737
</li>
1738
1739
</ul>
1740
</nav>
1741
1742
</li>
1743
1744
<li class="md-nav__item">
1745
<a href="#knowledge-graph-issues" class="md-nav__link">
1746
<span class="md-ellipsis">
1747
1748
Knowledge graph issues
1749
1750
</span>
1751
</a>
1752
1753
<nav class="md-nav" aria-label="Knowledge graph issues">
1754
<ul class="md-nav__list">
1755
1756
<li class="md-nav__item">
1757
<a href="#no-knowledge-graph-loaded-in-companion" class="md-nav__link">
1758
<span class="md-ellipsis">
1759
1760
"No knowledge graph loaded" in companion
1761
1762
</span>
1763
</a>
1764
1765
</li>
1766
1767
<li class="md-nav__item">
1768
<a href="#empty-or-sparse-knowledge-graph" class="md-nav__link">
1769
<span class="md-ellipsis">
1770
1771
Empty or sparse knowledge graph
1772
1773
</span>
1774
</a>
1775
1776
</li>
1777
1778
<li class="md-nav__item">
1779
<a href="#duplicate-entities-after-merge" class="md-nav__link">
1780
<span class="md-ellipsis">
1781
1782
Duplicate entities after merge
1783
1784
</span>
1785
</a>
1786
1787
</li>
1788
1789
</ul>
1790
</nav>
1791
1792
</li>
1793
1794
<li class="md-nav__item">
1795
<a href="#companion-repl-issues" class="md-nav__link">
1796
<span class="md-ellipsis">
1797
1798
Companion / REPL issues
1799
1800
</span>
1801
</a>
1802
1803
<nav class="md-nav" aria-label="Companion / REPL issues">
1804
<ul class="md-nav__list">
1805
1806
<li class="md-nav__item">
1807
<a href="#chat-gives-generic-advice-instead-of-project-specific-answers" class="md-nav__link">
1808
<span class="md-ellipsis">
1809
1810
Chat gives generic advice instead of project-specific answers
1811
1812
</span>
1813
</a>
1814
1815
</li>
1816
1817
<li class="md-nav__item">
1818
<a href="#companion-is-slow" class="md-nav__link">
1819
<span class="md-ellipsis">
1820
1821
Companion is slow
1822
1823
</span>
1824
</a>
1825
1826
</li>
1827
1828
</ul>
1829
</nav>
1830
1831
</li>
1832
1833
<li class="md-nav__item">
1834
<a href="#export-issues" class="md-nav__link">
1835
<span class="md-ellipsis">
1836
1837
Export issues
1838
1839
</span>
1840
</a>
1841
1842
<nav class="md-nav" aria-label="Export issues">
1843
<ul class="md-nav__list">
1844
1845
<li class="md-nav__item">
1846
<a href="#obsidian-export-has-broken-links" class="md-nav__link">
1847
<span class="md-ellipsis">
1848
1849
Obsidian export has broken links
1850
1851
</span>
1852
</a>
1853
1854
</li>
1855
1856
<li class="md-nav__item">
1857
<a href="#pdf-export-fails" class="md-nav__link">
1858
<span class="md-ellipsis">
1859
1860
PDF export fails
1861
1862
</span>
1863
</a>
1864
1865
</li>
1866
1867
</ul>
1868
</nav>
1869
1870
</li>
1871
1872
</ul>
1873
</nav>
1874
1875
</li>
1876
1877
</ul>
1878
1879
</nav>
1880
1881
</li>
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
<li class="md-nav__item">
1892
<a href="../contributing/" class="md-nav__link">
1893
1894
1895
1896
<span class="md-ellipsis">
1897
1898
1899
Contributing
1900
1901
1902
1903
</span>
1904
1905
1906
1907
</a>
1908
</li>
1909
1910
1911
1912
</ul>
1913
</nav>
1914
</div>
1915
</div>
1916
</div>
1917
1918
1919
1920
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
1921
<div class="md-sidebar__scrollwrap">
1922
<div class="md-sidebar__inner">
1923
1924
1925
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1926
1927
1928
1929
1930
1931
1932
<label class="md-nav__title" for="__toc">
1933
<span class="md-nav__icon md-icon"></span>
1934
Table of contents
1935
</label>
1936
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1937
1938
<li class="md-nav__item">
1939
<a href="#frequently-asked-questions" class="md-nav__link">
1940
<span class="md-ellipsis">
1941
1942
Frequently Asked Questions
1943
1944
</span>
1945
</a>
1946
1947
<nav class="md-nav" aria-label="Frequently Asked Questions">
1948
<ul class="md-nav__list">
1949
1950
<li class="md-nav__item">
1951
<a href="#do-i-need-an-api-key" class="md-nav__link">
1952
<span class="md-ellipsis">
1953
1954
Do I need an API key?
1955
1956
</span>
1957
</a>
1958
1959
</li>
1960
1961
<li class="md-nav__item">
1962
<a href="#how-much-does-it-cost" class="md-nav__link">
1963
<span class="md-ellipsis">
1964
1965
How much does it cost?
1966
1967
</span>
1968
</a>
1969
1970
</li>
1971
1972
<li class="md-nav__item">
1973
<a href="#can-i-run-fully-offline" class="md-nav__link">
1974
<span class="md-ellipsis">
1975
1976
Can I run fully offline?
1977
1978
</span>
1979
</a>
1980
1981
</li>
1982
1983
<li class="md-nav__item">
1984
<a href="#what-video-formats-are-supported" class="md-nav__link">
1985
<span class="md-ellipsis">
1986
1987
What video formats are supported?
1988
1989
</span>
1990
</a>
1991
1992
</li>
1993
1994
<li class="md-nav__item">
1995
<a href="#what-document-formats-can-i-ingest" class="md-nav__link">
1996
<span class="md-ellipsis">
1997
1998
What document formats can I ingest?
1999
2000
</span>
2001
</a>
2002
2003
</li>
2004
2005
<li class="md-nav__item">
2006
<a href="#how-does-the-knowledge-graph-work" class="md-nav__link">
2007
<span class="md-ellipsis">
2008
2009
How does the knowledge graph work?
2010
2011
</span>
2012
</a>
2013
2014
</li>
2015
2016
<li class="md-nav__item">
2017
<a href="#can-i-use-planopticon-with-my-existing-obsidian-vault" class="md-nav__link">
2018
<span class="md-ellipsis">
2019
2020
Can I use PlanOpticon with my existing Obsidian vault?
2021
2022
</span>
2023
</a>
2024
2025
</li>
2026
2027
<li class="md-nav__item">
2028
<a href="#how-do-i-add-my-own-ai-provider" class="md-nav__link">
2029
<span class="md-ellipsis">
2030
2031
How do I add my own AI provider?
2032
2033
</span>
2034
</a>
2035
2036
</li>
2037
2038
</ul>
2039
</nav>
2040
2041
</li>
2042
2043
<li class="md-nav__item">
2044
<a href="#troubleshooting" class="md-nav__link">
2045
<span class="md-ellipsis">
2046
2047
Troubleshooting
2048
2049
</span>
2050
</a>
2051
2052
<nav class="md-nav" aria-label="Troubleshooting">
2053
<ul class="md-nav__list">
2054
2055
<li class="md-nav__item">
2056
<a href="#authentication-errors" class="md-nav__link">
2057
<span class="md-ellipsis">
2058
2059
Authentication errors
2060
2061
</span>
2062
</a>
2063
2064
<nav class="md-nav" aria-label="Authentication errors">
2065
<ul class="md-nav__list">
2066
2067
<li class="md-nav__item">
2068
<a href="#no-auth-method-available-for-zoom" class="md-nav__link">
2069
<span class="md-ellipsis">
2070
2071
"No auth method available for zoom"
2072
2073
</span>
2074
</a>
2075
2076
</li>
2077
2078
<li class="md-nav__item">
2079
<a href="#token-expired-or-401-unauthorized" class="md-nav__link">
2080
<span class="md-ellipsis">
2081
2082
"Token expired" or "401 Unauthorized"
2083
2084
</span>
2085
</a>
2086
2087
</li>
2088
2089
<li class="md-nav__item">
2090
<a href="#oauth-redirect-errors" class="md-nav__link">
2091
<span class="md-ellipsis">
2092
2093
OAuth redirect errors
2094
2095
</span>
2096
</a>
2097
2098
</li>
2099
2100
</ul>
2101
</nav>
2102
2103
</li>
2104
2105
<li class="md-nav__item">
2106
<a href="#provider-errors" class="md-nav__link">
2107
<span class="md-ellipsis">
2108
2109
Provider errors
2110
2111
</span>
2112
</a>
2113
2114
<nav class="md-nav" aria-label="Provider errors">
2115
<ul class="md-nav__list">
2116
2117
<li class="md-nav__item">
2118
<a href="#anthropic_api_key-not-set" class="md-nav__link">
2119
<span class="md-ellipsis">
2120
2121
"ANTHROPIC_API_KEY not set"
2122
2123
</span>
2124
</a>
2125
2126
</li>
2127
2128
<li class="md-nav__item">
2129
<a href="#unexpected-role-system-anthropic" class="md-nav__link">
2130
<span class="md-ellipsis">
2131
2132
"Unexpected role system" (Anthropic)
2133
2134
</span>
2135
</a>
2136
2137
</li>
2138
2139
<li class="md-nav__item">
2140
<a href="#model-not-found-or-invalid-model" class="md-nav__link">
2141
<span class="md-ellipsis">
2142
2143
"Model not found" or "Invalid model"
2144
2145
</span>
2146
</a>
2147
2148
</li>
2149
2150
<li class="md-nav__item">
2151
<a href="#rate-limiting-429-errors" class="md-nav__link">
2152
<span class="md-ellipsis">
2153
2154
Rate limiting / 429 errors
2155
2156
</span>
2157
</a>
2158
2159
</li>
2160
2161
</ul>
2162
</nav>
2163
2164
</li>
2165
2166
<li class="md-nav__item">
2167
<a href="#processing-errors" class="md-nav__link">
2168
<span class="md-ellipsis">
2169
2170
Processing errors
2171
2172
</span>
2173
</a>
2174
2175
<nav class="md-nav" aria-label="Processing errors">
2176
<ul class="md-nav__list">
2177
2178
<li class="md-nav__item">
2179
<a href="#ffmpeg-not-found" class="md-nav__link">
2180
<span class="md-ellipsis">
2181
2182
"FFmpeg not found"
2183
2184
</span>
2185
</a>
2186
2187
</li>
2188
2189
<li class="md-nav__item">
2190
<a href="#audio-extraction-failed-no-audio-track-found" class="md-nav__link">
2191
<span class="md-ellipsis">
2192
2193
"Audio extraction failed: no audio track found"
2194
2195
</span>
2196
</a>
2197
2198
</li>
2199
2200
<li class="md-nav__item">
2201
<a href="#frame-extraction-memory-error" class="md-nav__link">
2202
<span class="md-ellipsis">
2203
2204
"Frame extraction memory error"
2205
2206
</span>
2207
</a>
2208
2209
</li>
2210
2211
<li class="md-nav__item">
2212
<a href="#batch-processing-one-video-fails" class="md-nav__link">
2213
<span class="md-ellipsis">
2214
2215
Batch processing — one video fails
2216
2217
</span>
2218
</a>
2219
2220
</li>
2221
2222
</ul>
2223
</nav>
2224
2225
</li>
2226
2227
<li class="md-nav__item">
2228
<a href="#knowledge-graph-issues" class="md-nav__link">
2229
<span class="md-ellipsis">
2230
2231
Knowledge graph issues
2232
2233
</span>
2234
</a>
2235
2236
<nav class="md-nav" aria-label="Knowledge graph issues">
2237
<ul class="md-nav__list">
2238
2239
<li class="md-nav__item">
2240
<a href="#no-knowledge-graph-loaded-in-companion" class="md-nav__link">
2241
<span class="md-ellipsis">
2242
2243
"No knowledge graph loaded" in companion
2244
2245
</span>
2246
</a>
2247
2248
</li>
2249
2250
<li class="md-nav__item">
2251
<a href="#empty-or-sparse-knowledge-graph" class="md-nav__link">
2252
<span class="md-ellipsis">
2253
2254
Empty or sparse knowledge graph
2255
2256
</span>
2257
</a>
2258
2259
</li>
2260
2261
<li class="md-nav__item">
2262
<a href="#duplicate-entities-after-merge" class="md-nav__link">
2263
<span class="md-ellipsis">
2264
2265
Duplicate entities after merge
2266
2267
</span>
2268
</a>
2269
2270
</li>
2271
2272
</ul>
2273
</nav>
2274
2275
</li>
2276
2277
<li class="md-nav__item">
2278
<a href="#companion-repl-issues" class="md-nav__link">
2279
<span class="md-ellipsis">
2280
2281
Companion / REPL issues
2282
2283
</span>
2284
</a>
2285
2286
<nav class="md-nav" aria-label="Companion / REPL issues">
2287
<ul class="md-nav__list">
2288
2289
<li class="md-nav__item">
2290
<a href="#chat-gives-generic-advice-instead-of-project-specific-answers" class="md-nav__link">
2291
<span class="md-ellipsis">
2292
2293
Chat gives generic advice instead of project-specific answers
2294
2295
</span>
2296
</a>
2297
2298
</li>
2299
2300
<li class="md-nav__item">
2301
<a href="#companion-is-slow" class="md-nav__link">
2302
<span class="md-ellipsis">
2303
2304
Companion is slow
2305
2306
</span>
2307
</a>
2308
2309
</li>
2310
2311
</ul>
2312
</nav>
2313
2314
</li>
2315
2316
<li class="md-nav__item">
2317
<a href="#export-issues" class="md-nav__link">
2318
<span class="md-ellipsis">
2319
2320
Export issues
2321
2322
</span>
2323
</a>
2324
2325
<nav class="md-nav" aria-label="Export issues">
2326
<ul class="md-nav__list">
2327
2328
<li class="md-nav__item">
2329
<a href="#obsidian-export-has-broken-links" class="md-nav__link">
2330
<span class="md-ellipsis">
2331
2332
Obsidian export has broken links
2333
2334
</span>
2335
</a>
2336
2337
</li>
2338
2339
<li class="md-nav__item">
2340
<a href="#pdf-export-fails" class="md-nav__link">
2341
<span class="md-ellipsis">
2342
2343
PDF export fails
2344
2345
</span>
2346
</a>
2347
2348
</li>
2349
2350
</ul>
2351
</nav>
2352
2353
</li>
2354
2355
</ul>
2356
</nav>
2357
2358
</li>
2359
2360
</ul>
2361
2362
</nav>
2363
</div>
2364
</div>
2365
</div>
2366
2367
2368
2369
<div class="md-content" data-md-component="content">
2370
2371
<article class="md-content__inner md-typeset">
2372
2373
2374
2375
2376
2377
2378
2379
2380
<h1 id="faq-troubleshooting">FAQ &amp; Troubleshooting<a class="headerlink" href="#faq-troubleshooting" title="Permanent link">&para;</a></h1>
2381
<h2 id="frequently-asked-questions">Frequently Asked Questions<a class="headerlink" href="#frequently-asked-questions" title="Permanent link">&para;</a></h2>
2382
<h3 id="do-i-need-an-api-key">Do I need an API key?<a class="headerlink" href="#do-i-need-an-api-key" title="Permanent link">&para;</a></h3>
2383
<p>You need at least one of:</p>
2384
<ul>
2385
<li><strong>Cloud API key</strong>: <code>OPENAI_API_KEY</code>, <code>ANTHROPIC_API_KEY</code>, or <code>GEMINI_API_KEY</code></li>
2386
<li><strong>Local Ollama</strong>: Install <a href="https://ollama.com">Ollama</a>, pull a model, and run <code>ollama serve</code></li>
2387
</ul>
2388
<p>Some features work without any AI provider:</p>
2389
<ul>
2390
<li><code>planopticon query stats</code> — direct knowledge graph queries</li>
2391
<li><code>planopticon query "entities --type person"</code> — structured entity lookups</li>
2392
<li><code>planopticon export markdown</code> — document generation from existing KG (7 document types, no LLM)</li>
2393
<li><code>planopticon kg inspect</code> — knowledge graph statistics</li>
2394
<li><code>planopticon kg convert</code> — format conversion</li>
2395
</ul>
2396
<h3 id="how-much-does-it-cost">How much does it cost?<a class="headerlink" href="#how-much-does-it-cost" title="Permanent link">&para;</a></h3>
2397
<p>PlanOpticon defaults to cheap models to minimize costs:</p>
2398
<table>
2399
<thead>
2400
<tr>
2401
<th>Task</th>
2402
<th>Default model</th>
2403
<th>Approximate cost</th>
2404
</tr>
2405
</thead>
2406
<tbody>
2407
<tr>
2408
<td>Chat/analysis</td>
2409
<td>Claude Haiku / GPT-4o-mini</td>
2410
<td>~$0.25-0.50 per 1M tokens</td>
2411
</tr>
2412
<tr>
2413
<td>Vision (diagrams)</td>
2414
<td>Gemini Flash / GPT-4o-mini</td>
2415
<td>~$0.10-0.50 per 1M tokens</td>
2416
</tr>
2417
<tr>
2418
<td>Transcription</td>
2419
<td>Local Whisper (free) / Whisper-1</td>
2420
<td>$0.006/minute</td>
2421
</tr>
2422
</tbody>
2423
</table>
2424
<p>A typical 1-hour meeting costs roughly $0.05-0.15 to process with default models. Use <code>--provider ollama</code> for zero cost.</p>
2425
<h3 id="can-i-run-fully-offline">Can I run fully offline?<a class="headerlink" href="#can-i-run-fully-offline" title="Permanent link">&para;</a></h3>
2426
<p>Yes. Install Ollama and local Whisper:</p>
2427
<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>ollama<span class="w"> </span>pull<span class="w"> </span>llama3.2
2428
<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>ollama<span class="w"> </span>pull<span class="w"> </span>llava
2429
<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>pip<span class="w"> </span>install<span class="w"> </span>planopticon<span class="o">[</span>gpu<span class="o">]</span>
2430
<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--provider<span class="w"> </span>ollama
2431
</code></pre></div>
2432
<p>No data leaves your machine.</p>
2433
<h3 id="what-video-formats-are-supported">What video formats are supported?<a class="headerlink" href="#what-video-formats-are-supported" title="Permanent link">&para;</a></h3>
2434
<p>Any format FFmpeg can decode:</p>
2435
<ul>
2436
<li>MP4, MKV, AVI, MOV, WebM, FLV, WMV, M4V</li>
2437
<li>Container formats with common codecs (H.264, H.265, VP8, VP9, AV1)</li>
2438
</ul>
2439
<h3 id="what-document-formats-can-i-ingest">What document formats can I ingest?<a class="headerlink" href="#what-document-formats-can-i-ingest" title="Permanent link">&para;</a></h3>
2440
<ul>
2441
<li><strong>PDF</strong> — text extraction via pymupdf or pdfplumber</li>
2442
<li><strong>Markdown</strong> — parsed with heading-based chunking</li>
2443
<li><strong>Plain text</strong> — paragraph-based chunking with overlap</li>
2444
</ul>
2445
<h3 id="how-does-the-knowledge-graph-work">How does the knowledge graph work?<a class="headerlink" href="#how-does-the-knowledge-graph-work" title="Permanent link">&para;</a></h3>
2446
<p>PlanOpticon extracts entities (people, technologies, concepts, decisions) and relationships from your content. These are stored in a SQLite database (<code>knowledge_graph.db</code>) with zero external dependencies. Entities are automatically classified using a planning taxonomy (goals, requirements, risks, tasks, milestones).</p>
2447
<p>When you process multiple sources, entities are merged using fuzzy name matching (0.85 threshold) with type conflict resolution and provenance tracking.</p>
2448
<h3 id="can-i-use-planopticon-with-my-existing-obsidian-vault">Can I use PlanOpticon with my existing Obsidian vault?<a class="headerlink" href="#can-i-use-planopticon-with-my-existing-obsidian-vault" title="Permanent link">&para;</a></h3>
2449
<p>Yes, in both directions:</p>
2450
<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="c1"># Ingest an Obsidian vault into PlanOpticon</span>
2451
<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>planopticon<span class="w"> </span>ingest<span class="w"> </span>~/Obsidian/MyVault<span class="w"> </span>--output<span class="w"> </span>./kb<span class="w"> </span>--recursive
2452
<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>
2453
<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="c1"># Export PlanOpticon knowledge to an Obsidian vault</span>
2454
<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>planopticon<span class="w"> </span><span class="nb">export</span><span class="w"> </span>obsidian<span class="w"> </span>--input<span class="w"> </span>./kb<span class="w"> </span>--output<span class="w"> </span>~/Obsidian/PlanOpticon
2455
</code></pre></div>
2456
<p>The Obsidian export produces proper YAML frontmatter, wiki-links (<code>[[Entity Name]]</code>), and tag pages.</p>
2457
<h3 id="how-do-i-add-my-own-ai-provider">How do I add my own AI provider?<a class="headerlink" href="#how-do-i-add-my-own-ai-provider" title="Permanent link">&para;</a></h3>
2458
<p>Create a provider module, extend <code>BaseProvider</code>, and register it:</p>
2459
<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.providers.base</span><span class="w"> </span><span class="kn">import</span> <span class="n">BaseProvider</span><span class="p">,</span> <span class="n">ProviderRegistry</span>
2460
<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>
2461
<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="k">class</span><span class="w"> </span><span class="nc">MyProvider</span><span class="p">(</span><span class="n">BaseProvider</span><span class="p">):</span>
2462
<a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a> <span class="n">provider_name</span> <span class="o">=</span> <span class="s2">&quot;myprovider&quot;</span>
2463
<a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>
2464
<a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a> <span class="k">def</span><span class="w"> </span><span class="nf">chat</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">messages</span><span class="p">,</span> <span class="n">max_tokens</span><span class="o">=</span><span class="mi">4096</span><span class="p">,</span> <span class="n">temperature</span><span class="o">=</span><span class="mf">0.7</span><span class="p">,</span> <span class="n">model</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
2465
<a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a> <span class="c1"># Your implementation</span>
2466
<a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a> <span class="o">...</span>
2467
<a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
2468
<a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="n">ProviderRegistry</span><span class="o">.</span><span class="n">register</span><span class="p">(</span>
2469
<a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;myprovider&quot;</span><span class="p">,</span>
2470
<a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a> <span class="n">provider_class</span><span class="o">=</span><span class="n">MyProvider</span><span class="p">,</span>
2471
<a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a> <span class="n">env_var</span><span class="o">=</span><span class="s2">&quot;MY_PROVIDER_API_KEY&quot;</span><span class="p">,</span>
2472
<a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a> <span class="n">model_prefixes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;my-&quot;</span><span class="p">],</span>
2473
<a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a> <span class="n">default_models</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat&quot;</span><span class="p">:</span> <span class="s2">&quot;my-model-v1&quot;</span><span class="p">,</span> <span class="s2">&quot;vision&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="s2">&quot;audio&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">},</span>
2474
<a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="p">)</span>
2475
</code></pre></div>
2476
<p>See the <a href="../contributing/">Contributing guide</a> for details.</p>
2477
<hr />
2478
<h2 id="troubleshooting">Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permanent link">&para;</a></h2>
2479
<h3 id="authentication-errors">Authentication errors<a class="headerlink" href="#authentication-errors" title="Permanent link">&para;</a></h3>
2480
<h4 id="no-auth-method-available-for-zoom">"No auth method available for zoom"<a class="headerlink" href="#no-auth-method-available-for-zoom" title="Permanent link">&para;</a></h4>
2481
<p>You need to set credentials before authenticating:</p>
2482
<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ZOOM_CLIENT_ID</span><span class="o">=</span><span class="s2">&quot;your-client-id&quot;</span>
2483
<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ZOOM_CLIENT_SECRET</span><span class="o">=</span><span class="s2">&quot;your-client-secret&quot;</span>
2484
<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>planopticon<span class="w"> </span>auth<span class="w"> </span>zoom
2485
</code></pre></div>
2486
<p>The error message tells you which environment variables to set. Each service requires different credentials — see the <a href="../guide/authentication/">Authentication guide</a>.</p>
2487
<h4 id="token-expired-or-401-unauthorized">"Token expired" or "401 Unauthorized"<a class="headerlink" href="#token-expired-or-401-unauthorized" title="Permanent link">&para;</a></h4>
2488
<p>Your saved token has expired and auto-refresh failed. Re-authenticate:</p>
2489
<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>planopticon<span class="w"> </span>auth<span class="w"> </span>google<span class="w"> </span><span class="c1"># or whatever service</span>
2490
</code></pre></div>
2491
<p>To clear a stale token:</p>
2492
<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>planopticon<span class="w"> </span>auth<span class="w"> </span>google<span class="w"> </span>--logout
2493
<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>planopticon<span class="w"> </span>auth<span class="w"> </span>google
2494
</code></pre></div>
2495
<p>Tokens are stored in <code>~/.planopticon/{service}_token.json</code>.</p>
2496
<h4 id="oauth-redirect-errors">OAuth redirect errors<a class="headerlink" href="#oauth-redirect-errors" title="Permanent link">&para;</a></h4>
2497
<p>If the browser-based OAuth flow fails, check:</p>
2498
<ol>
2499
<li>Your client ID and secret are correct</li>
2500
<li>The redirect URI in your OAuth app matches PlanOpticon's default (<code>urn:ietf:wg:oauth:2.0:oob</code>)</li>
2501
<li>The OAuth app has the required scopes enabled</li>
2502
</ol>
2503
<h3 id="provider-errors">Provider errors<a class="headerlink" href="#provider-errors" title="Permanent link">&para;</a></h3>
2504
<h4 id="anthropic_api_key-not-set">"ANTHROPIC_API_KEY not set"<a class="headerlink" href="#anthropic_api_key-not-set" title="Permanent link">&para;</a></h4>
2505
<p>Set at least one provider's API key:</p>
2506
<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">OPENAI_API_KEY</span><span class="o">=</span><span class="s2">&quot;sk-...&quot;</span>
2507
<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="c1"># or</span>
2508
<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ANTHROPIC_API_KEY</span><span class="o">=</span><span class="s2">&quot;sk-ant-...&quot;</span>
2509
<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="c1"># or</span>
2510
<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GEMINI_API_KEY</span><span class="o">=</span><span class="s2">&quot;AI...&quot;</span>
2511
</code></pre></div>
2512
<p>Or use a <code>.env</code> file in your project directory.</p>
2513
<h4 id="unexpected-role-system-anthropic">"Unexpected role system" (Anthropic)<a class="headerlink" href="#unexpected-role-system-anthropic" title="Permanent link">&para;</a></h4>
2514
<p>This was a bug in older versions where system messages were passed in the messages array instead of as a top-level parameter. Update to v0.4.0 or later.</p>
2515
<h4 id="model-not-found-or-invalid-model">"Model not found" or "Invalid model"<a class="headerlink" href="#model-not-found-or-invalid-model" title="Permanent link">&para;</a></h4>
2516
<p>Check available models:</p>
2517
<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>planopticon<span class="w"> </span>list-models
2518
</code></pre></div>
2519
<p>Common model name issues:
2520
- Anthropic: use <code>claude-haiku-4-5-20251001</code>, not <code>claude-haiku</code>
2521
- OpenAI: use <code>gpt-4o-mini</code>, not <code>gpt4o-mini</code></p>
2522
<h4 id="rate-limiting-429-errors">Rate limiting / 429 errors<a class="headerlink" href="#rate-limiting-429-errors" title="Permanent link">&para;</a></h4>
2523
<p>PlanOpticon doesn't currently implement automatic retry. If you hit rate limits:</p>
2524
<ol>
2525
<li>Use a different provider: <code>--provider gemini</code></li>
2526
<li>Use cheaper/faster models: <code>--chat-model gpt-4o-mini</code></li>
2527
<li>Reduce processing depth: <code>--depth basic</code></li>
2528
<li>Use Ollama for zero rate limits: <code>--provider ollama</code></li>
2529
</ol>
2530
<h3 id="processing-errors">Processing errors<a class="headerlink" href="#processing-errors" title="Permanent link">&para;</a></h3>
2531
<h4 id="ffmpeg-not-found">"FFmpeg not found"<a class="headerlink" href="#ffmpeg-not-found" title="Permanent link">&para;</a></h4>
2532
<p>Install FFmpeg:</p>
2533
<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="c1"># macOS</span>
2534
<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>brew<span class="w"> </span>install<span class="w"> </span>ffmpeg
2535
<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a>
2536
<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1"># Ubuntu/Debian</span>
2537
<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a>sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>ffmpeg<span class="w"> </span>libsndfile1
2538
<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a>
2539
<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="c1"># Windows</span>
2540
<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="c1"># Download from https://ffmpeg.org/download.html and add to PATH</span>
2541
</code></pre></div>
2542
<h4 id="audio-extraction-failed-no-audio-track-found">"Audio extraction failed: no audio track found"<a class="headerlink" href="#audio-extraction-failed-no-audio-track-found" title="Permanent link">&para;</a></h4>
2543
<p>The video file has no audio track. PlanOpticon will skip transcription and continue with frame analysis only.</p>
2544
<h4 id="frame-extraction-memory-error">"Frame extraction memory error"<a class="headerlink" href="#frame-extraction-memory-error" title="Permanent link">&para;</a></h4>
2545
<p>For very long videos, frame extraction can use significant memory. Use the <code>--max-memory-mb</code> safety valve:</p>
2546
<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>long-video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--max-memory-mb<span class="w"> </span><span class="m">2048</span>
2547
</code></pre></div>
2548
<p>Or reduce the sampling rate:</p>
2549
<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>long-video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--sampling-rate<span class="w"> </span><span class="m">0</span>.25
2550
</code></pre></div>
2551
<h4 id="batch-processing-one-video-fails">Batch processing — one video fails<a class="headerlink" href="#batch-processing-one-video-fails" title="Permanent link">&para;</a></h4>
2552
<p>Individual video failures don't stop the batch. Failed videos are logged in the batch manifest with error details. Check <code>batch_manifest.json</code> for the specific error.</p>
2553
<h3 id="knowledge-graph-issues">Knowledge graph issues<a class="headerlink" href="#knowledge-graph-issues" title="Permanent link">&para;</a></h3>
2554
<h4 id="no-knowledge-graph-loaded-in-companion">"No knowledge graph loaded" in companion<a class="headerlink" href="#no-knowledge-graph-loaded-in-companion" title="Permanent link">&para;</a></h4>
2555
<p>The companion auto-discovers knowledge graphs by looking for <code>knowledge_graph.db</code> or <code>knowledge_graph.json</code> in the current directory and parent directories. Either:</p>
2556
<ol>
2557
<li><code>cd</code> to the directory containing your knowledge graph</li>
2558
<li>Specify the path explicitly: <code>planopticon companion --kb ./path/to/kb</code></li>
2559
</ol>
2560
<h4 id="empty-or-sparse-knowledge-graph">Empty or sparse knowledge graph<a class="headerlink" href="#empty-or-sparse-knowledge-graph" title="Permanent link">&para;</a></h4>
2561
<p>Common causes:</p>
2562
<ol>
2563
<li><strong>Too few entities extracted</strong>: Try <code>--depth comprehensive</code> for deeper analysis</li>
2564
<li><strong>Short or low-quality transcript</strong>: Check <code>transcript/transcript.txt</code> — poor audio produces poor transcription</li>
2565
<li><strong>Wrong provider</strong>: Some models extract entities better than others. Try <code>--provider openai --chat-model gpt-4o</code> for higher quality</li>
2566
</ol>
2567
<h4 id="duplicate-entities-after-merge">Duplicate entities after merge<a class="headerlink" href="#duplicate-entities-after-merge" title="Permanent link">&para;</a></h4>
2568
<p>The fuzzy matching threshold is 0.85 (SequenceMatcher ratio). If you're getting duplicates, the names are too different for automatic matching. You can manually inspect and merge:</p>
2569
<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>planopticon<span class="w"> </span>kg<span class="w"> </span>inspect<span class="w"> </span>./knowledge_graph.db
2570
<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>planopticon<span class="w"> </span>query<span class="w"> </span><span class="s2">&quot;entities --name python&quot;</span>
2571
</code></pre></div>
2572
<h3 id="companion-repl-issues">Companion / REPL issues<a class="headerlink" href="#companion-repl-issues" title="Permanent link">&para;</a></h3>
2573
<h4 id="chat-gives-generic-advice-instead-of-project-specific-answers">Chat gives generic advice instead of project-specific answers<a class="headerlink" href="#chat-gives-generic-advice-instead-of-project-specific-answers" title="Permanent link">&para;</a></h4>
2574
<p>The companion needs both a knowledge graph and an LLM provider. Check:</p>
2575
<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>planopticon&gt; /status
2576
</code></pre></div>
2577
<p>If it says "KG: not loaded" or "Provider: none", fix those first:</p>
2578
<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>planopticon&gt; /provider openai
2579
<a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>planopticon&gt; /model gpt-4o-mini
2580
</code></pre></div>
2581
<h4 id="companion-is-slow">Companion is slow<a class="headerlink" href="#companion-is-slow" title="Permanent link">&para;</a></h4>
2582
<p>The companion makes LLM API calls for chat messages. To speed things up:</p>
2583
<ol>
2584
<li>Use a faster model: <code>/model gpt-4o-mini</code> or <code>/model claude-haiku-4-5-20251001</code></li>
2585
<li>Use direct queries instead of chat: <code>/entities</code>, <code>/search</code>, <code>/neighbors</code> don't need an LLM</li>
2586
<li>Use Ollama locally for lower latency: <code>/provider ollama</code></li>
2587
</ol>
2588
<h3 id="export-issues">Export issues<a class="headerlink" href="#export-issues" title="Permanent link">&para;</a></h3>
2589
<h4 id="obsidian-export-has-broken-links">Obsidian export has broken links<a class="headerlink" href="#obsidian-export-has-broken-links" title="Permanent link">&para;</a></h4>
2590
<p>Make sure your Obsidian vault has wiki-links enabled (Settings &gt; Files &amp; Links &gt; Use [[Wikilinks]]). PlanOpticon exports use wiki-link syntax by default.</p>
2591
<h4 id="pdf-export-fails">PDF export fails<a class="headerlink" href="#pdf-export-fails" title="Permanent link">&para;</a></h4>
2592
<p>PDF export requires the <code>pdf</code> extra:</p>
2593
<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>pip<span class="w"> </span>install<span class="w"> </span>planopticon<span class="o">[</span>pdf<span class="o">]</span>
2594
</code></pre></div>
2595
<p>This installs WeasyPrint, which has system dependencies. On macOS:</p>
2596
<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>brew<span class="w"> </span>install<span class="w"> </span>pango
2597
</code></pre></div>
2598
<p>On Ubuntu:</p>
2599
<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>libpango1.0-dev
2600
</code></pre></div>
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
</article>
2615
</div>
2616
2617
2618
<script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
2619
2620
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
2621
</div>
2622
2623
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
2624
2625
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
2626
Back to top
2627
</button>
2628
2629
</main>
2630
2631
<footer class="md-footer">
2632
2633
<div class="md-footer-meta md-typeset">
2634
<div class="md-footer-meta__inner md-grid">
2635
<div class="md-copyright">
2636
2637
<div class="md-copyright__highlight">
2638
Copyright &copy; 2026 CONFLICT LLC
2639
</div>
2640
2641
2642
Made with
2643
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
2644
Material for MkDocs
2645
</a>
2646
2647
</div>
2648
2649
2650
<div class="md-social">
2651
2652
2653
2654
2655
2656
2657
2658
2659
<a href="https://github.com/ConflictHQ/PlanOpticon" target="_blank" rel="noopener" title="github.com" class="md-social__link">
2660
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
2661
</a>
2662
2663
</div>
2664
2665
</div>
2666
</div>
2667
</footer>
2668
2669
</div>
2670
<div class="md-dialog" data-md-component="dialog">
2671
<div class="md-dialog__inner md-typeset"></div>
2672
</div>
2673
2674
2675
2676
2677
2678
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
2679
2680
2681
<script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
2682
2683
2684
</body>
2685
</html>

Keyboard Shortcuts

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