How lacania/personal-workbench works
Personal Workbench is a local-first Windows desktop AI workspace for organizing files, studying documents, searching imported material, and turning web or video sources into learning resources. The principal flow is user request through the workbench UI and server task runtime, then source-specific ingestion and knowledge processing, with results available as documents or searchable memory. File organization adds a deliberate preview-and-confirm path; artifact review provides a separate evidence and approval capability. README documents Ollama and supported workflows; sampled excerpts do not expose complete route wiring, so uncertain calls are omitted.
Main entry points: manager.ts Task manager · App.tsx Workbench UI · client.ts API client · review-queue-service.ts Review workflow
Components 24
Desktop interface
- Workbench UI
apps/personal-workbench/web/src/App.tsx - Workbench page
apps/personal-workbench/web/src/pages/WorkbenchPage.tsx - Organizer page
apps/personal-workbench/web/src/pages/FileOrganizerPage.tsx - Memory page
apps/personal-workbench/web/src/pages/MemoryPage.tsx - Video page
apps/personal-workbench/web/src/pages/VideoPage.tsx - Review queue
apps/personal-workbench/web/src/pages/ReviewQueuePage.tsx - API client
apps/personal-workbench/web/src/api/client.ts
Task runtime
- Server entry
apps/personal-workbench/server/src/index.ts - Task manager
apps/personal-workbench/server/src/tasks/manager.ts - Workbench database
apps/personal-workbench/server/src/database.ts
Knowledge workflows
- Source ingestion
apps/personal-workbench/server/src/ingestion/service.ts - Source adapters
apps/personal-workbench/server/src/sources/registry.ts - Video processing
apps/personal-workbench/server/src/video/service.ts - Document search
apps/personal-workbench/server/src/documents/search-service.ts - Knowledge extraction
apps/personal-workbench/server/src/knowledge/service.ts - Local retrieval
apps/personal-workbench/server/src/retrieval/service.ts
Workspace operations
- File organizer
apps/personal-workbench/server/src/organizer/service.ts - Project workspace
apps/personal-workbench/server/src/projects/service.ts
Evidence and review
- Artifact services
apps/personal-workbench/server/src/artifacts/service.ts - Review workflow
apps/personal-workbench/server/src/artifacts/review-queue-service.ts - Review policy
apps/personal-workbench/server/src/artifacts/review-policy-service.ts - Review changes
apps/personal-workbench/server/src/artifacts/review-change-service.ts
Other components
- User
- Ollama
Connections 32
- User → Workbench UI: uses
- Workbench UI → Workbench page: shows
- Workbench UI → Organizer page: shows
- Workbench UI → Memory page: shows
- Workbench UI → Video page: shows
- Workbench UI → Review queue: shows
- Workbench page → API client: requests tasks
- Organizer page → API client: requests plans
- Memory page → API client: requests memory
- Video page → API client: requests video
- Review queue → API client: requests reviews
- API client → Server entry: sends requests
- Server entry → Task manager: dispatches tasks
- Task manager → Workbench database: reads and writes
- Task manager → Ollama: uses local AI
- Task manager → Source ingestion: runs ingestion
- Source ingestion → Source adapters: resolves sources
- Task manager → Video processing: runs video tasks
- Task manager → Document search: indexes documents
- Task manager → Knowledge extraction: extracts knowledge
- Document search → Ollama: embeds text
- Document search → Workbench database: stores vectors
- Local retrieval → Workbench database: searches memory
- Task manager → File organizer: runs organization
- Task manager → Project workspace: manages projects
- Task manager → Artifact services: creates artifacts
- Review queue → Review workflow: submits decisions
- Review workflow → Review policy: evaluates policy
- Review workflow → Review changes: captures changes
- Review workflow → Workbench database: stores decisions
- Review policy → Artifact services: checks artifacts
- Review changes → Artifact services: compares artifacts