How jamesleondufour/kobo-autoqa works
Kobo AutoQA automates transcription, translation, and qualitative analysis for KoboToolbox submissions. Administrators configure accounts, connections, forms, webhooks, languages, and analysis questions through the web UI or CLI. Submissions enter through the webhook or polling catch-up, are queued in SQLite, and a worker advances each through asynchronous NLP stages before results are written back to Kobo supplemental details. The README documents major UI and workflow capabilities; several supporting modules are indexed but unsampled, so uncertain implementation links are omitted.
Main entry points: admin.py Admin API · pipeline.py Submission state machine · store.py SQLite store · kobo.py Kobo API client
Components 22
Setup and access
- Admin UI
app/static/index.html - Admin API
app/admin.py - Session auth
app/auth.py - Account management
app/users.py - Setup CLI
app/cli.py - Recording config
app/assetconf.py - Rate limiting
app/ratelimit.py
Submission intake
- Webhook receiver
app/webhook.py - Catch-up poller
app/worker.py - Worker loop
app/worker.py
NLP processing
- Submission state machine
app/pipeline.py - NLP payloads
app/payloads.py - Supplement handling
app/supplement.py
State and settings
- Environment settings
app/config.py - Runtime settings
app/runtime.py - SQLite store
app/store.py - Shared wiring
app/common.py
Kobo integration
- Kobo API client
app/kobo.py
Other components
- Administrator
- KoboToolbox
- Kobo submission
- Supplemental results
Connections 31
- Administrator → Admin UI: uses
README.md - Admin UI → Admin API: configures and monitors
README.md - Admin API → Session auth: authenticates
app/admin.py - Session auth → Account management: validates accounts
app/auth.py - Admin API → SQLite store: reads and updates
app/admin.py - Admin API → Kobo API client: configures and queries
app/admin.py - Admin API → Recording config: configures recordings
app/admin.py - Admin API → Rate limiting: limits requests
app/admin.py - Setup CLI → Submission state machine: runs jobs
app/cli.py - Setup CLI → SQLite store: queues and inspects
app/cli.py - Admin API → Runtime settings: saves connection settings
app/admin.py - Runtime settings → SQLite store: persists overrides
app/runtime.py - Administrator → Setup CLI: uses headlessly
README.md - KoboToolbox → Kobo submission: creates
README.md - Kobo submission → Webhook receiver: posts event
README.md - Webhook receiver → SQLite store: enqueues
app/webhook.py - Catch-up poller → Kobo API client: polls submissions
app/worker.py - Catch-up poller → SQLite store: enqueues missed jobs
app/worker.py - Worker loop → Submission state machine: processes queued jobs
app/worker.py - Worker loop → SQLite store: claims and reschedules
app/worker.py - Worker loop → Catch-up poller: runs catch-up polling
README.md - Submission state machine → Recording config: resolves recording settings
app/pipeline.py - Submission state machine → NLP payloads: builds and reads payloads
app/pipeline.py - Submission state machine → Supplement handling: checks NLP features
app/pipeline.py - Submission state machine → Kobo API client: requests and checks jobs
app/pipeline.py - Submission state machine → SQLite store: advances job stages
app/pipeline.py - Kobo API client → KoboToolbox: calls API
app/kobo.py - KoboToolbox → Supplemental results: stores NLP results
README.md - Admin API → KoboToolbox: registers hooks and configures NLP
README.md - Shared wiring → Runtime settings: applies connection overrides
app/common.py - Shared wiring → Kobo API client: constructs client
app/common.py