How amierlorenz/articulate works
Articulate is a personal academic-workflow application: it gathers course material and recordings, turns eligible inputs into notes and tasks, and writes durable results to a user vault. The main execution framework is a resumable source-to-item pipeline, run by named jobs; domain steps handle Canvas intake, Pocket polling, inbox notes, task extraction, and library matching. Calendar matching and citation processing support course context and knowledge enrichment. The excerpts and source index establish several calls and shared stores, but README content is absent and some integrations are unsampled, so uncertain links are omitted.
Main entry points: db.py SQLite state · pipeline.py Item pipeline · runner.py Model runner · vault.py Vault writer
Components 25
Run orchestration
- Job runner
src/articulate/core/jobs.py - Item pipeline
src/articulate/core/pipeline.py - Step registry
src/articulate/registry.py
Source intake
- Canvas intake
src/articulate/intake/canvas/pick.py - Exam intake
src/articulate/intake/canvas/exams.py - Pocket polling
src/articulate/pocket/source.py - Calendar matching
src/articulate/calendar/match.py
Knowledge processing
- Inbox notes
src/articulate/inbox/step.py - Transcript reader
src/articulate/inbox/transcript.py - Task extraction
src/articulate/tasks/extract.py - Task delivery
src/articulate/tasks/send.py - Citation intake
src/articulate/intake/cite/__init__.py - Library matching
src/articulate/intake/library/__init__.py
Models and runtime
- Model runner
src/articulate/core/models/runner.py - Configuration
src/articulate/core/config.py - Handoff schemas
src/articulate/core/handoff_schemas/imports.py
State and output
- SQLite state
src/articulate/core/db.py - Task queue
src/articulate/core/taskqueue.py - Flags and holds
src/articulate/core/flags.py - Vault writer
src/articulate/core/vault.py - Health checks
src/articulate/core/health.py - Run log
src/articulate/core/runlog.py - Path resolution
src/articulate/core/paths.py - ID helpers
src/articulate/core/ids.py
Other components
- Operator / scheduler
Connections 38
- Operator / scheduler → Job runner: starts jobs
- Job runner → SQLite state: records runs
src/articulate/core/jobs.py - Job runner → Item pipeline: runs steps
src/articulate/core/jobs.py - Step registry → Job runner: registers steps
src/articulate/registry.py - Canvas intake → Item pipeline: emits items
src/articulate/intake/canvas/pick.py - Canvas intake → Exam intake: uses exam intake
src/articulate/intake/canvas/pick.py - Pocket polling → Calendar matching: matches events
src/articulate/pocket/source.py - Pocket polling → Item pipeline: emits items
src/articulate/pocket/source.py - Inbox notes → Calendar matching: matches meetings
src/articulate/inbox/step.py - Inbox notes → Model runner: requests inference
src/articulate/inbox/step.py - Inbox notes → SQLite state: reads and writes
src/articulate/inbox/step.py - Inbox notes → Vault writer: writes notes
src/articulate/inbox/step.py - Task extraction → Transcript reader: reads transcripts
src/articulate/tasks/extract.py - Task extraction → Model runner: requests inference
src/articulate/tasks/extract.py - Task extraction → SQLite state: records extraction
src/articulate/tasks/extract.py - Task delivery → SQLite state: loads task state
src/articulate/tasks/send.py - Task delivery → Item pipeline: uses pipeline
src/articulate/tasks/send.py - Citation intake → Model runner: requests inference
src/articulate/intake/cite/__init__.py - Citation intake → SQLite state: stores citation state
src/articulate/intake/cite/__init__.py - Library matching → Model runner: judges matches
src/articulate/intake/library/__init__.py - Library matching → Item pipeline: uses pipeline
src/articulate/intake/library/__init__.py - Model runner → Configuration: loads model settings
src/articulate/core/models/runner.py - Model runner → SQLite state: tracks usage
src/articulate/core/models/runner.py - Item pipeline → SQLite state: persists item state
src/articulate/core/pipeline.py - Item pipeline → ID helpers: creates identifiers
src/articulate/core/pipeline.py - Flags and holds → SQLite state: stores flags
src/articulate/core/flags.py - Flags and holds → Item pipeline: holds items
src/articulate/core/flags.py - Flags and holds → Task queue: uses task queue
src/articulate/core/flags.py - Health checks → SQLite state: checks state
src/articulate/core/health.py - Health checks → Vault writer: checks vault
src/articulate/core/health.py - Health checks → Run log: checks run log
src/articulate/core/health.py - Task queue → SQLite state: persists queue
src/articulate/core/taskqueue.py - Run log → Vault writer: uses vault
src/articulate/core/runlog.py - Path resolution → Configuration: resolves config paths
src/articulate/core/paths.py - SQLite state → Path resolution: resolves database path
src/articulate/core/db.py - Vault writer → SQLite state: records notes
src/articulate/core/vault.py - Vault writer → ID helpers: generates identifiers
src/articulate/core/vault.py - Handoff schemas → SQLite state: defines import state