How cosmoswems/aqact works
AQACT is a local-first air-quality analysis workspace: users upload sensor exports, clean and explore them, run scientific analyses, and create plots and exports. Its AI assistant is a separate browser-led path, combining compact server-generated dataset context with Puter.js and a deterministic local fallback. The README documents the major capabilities; sampled source confirms the in-memory session store and assistant context/API boundary. Some route-to-module and plotting/export call details were not shown, so those links are omitted.
Main entry points: app.py Workspace API · assistant.js Assistant interface · assistant_api.py Assistant API · engine.py Local Q&A
Components 25
Data ingestion
- File reading
core/dataio.py - Sensor cleaners
cleaners
Analysis and publication
- AQI analysis
analysis/aqi.py - Station comparison
analysis/comparative.py - Compliance screening
analysis/compliance.py - Extreme values
analysis/extreme.py - Machine learning
analysis/machine_learning.py - Model evaluation
analysis/model_eval.py - Plot generation
plots/generators.py - Figure exports
api/export_api.py
Assistant
- Assistant interface
static/js/assistant.js - Assistant API
api/assistant_api.py - Dataset profiling
assistant/profiling.py - Compact context
assistant/context.py - Offline insights
assistant/insights.py - Local Q&A
assistant/engine.py - Puter transport
static/js/services/ai.js - Model routing
static/js/services/router.js - Local fallback
static/js/services/fallback.js
Application runtime
- Workspace API
app.py - Session state
core/sessions.py - JSON responses
core/serialization.py - Result cache
core/cache.py
Other components
- Analyst
- Puter.js
Connections 24
- Analyst → Workspace API: uploads data
README.md - Workspace API → File reading: reads files
app.py - Workspace API → Sensor cleaners: cleans exports
README.md - Workspace API → Session state: stores sessions
app.py - Workspace API → AQI analysis: runs AQI
README.md - Workspace API → Station comparison: compares stations
README.md - Workspace API → Compliance screening: screens limits
README.md - Workspace API → Extreme values: runs extremes
README.md - Workspace API → Machine learning: trains models
README.md - Workspace API → Model evaluation: evaluates models
README.md - Workspace API → Plot generation: generates plots
README.md - Analyst → Figure exports: requests figures
README.md - Assistant interface → Assistant API: requests context
README.md - Assistant API → Session state: reads session
api/assistant_api.py - Assistant API → Compact context: builds context
api/assistant_api.py - Compact context → Dataset profiling: uses profile
assistant/context.py - Assistant API → Local Q&A: serves local Q&A
- Local Q&A → Dataset profiling: analyzes data
assistant/engine.py - Local Q&A → Offline insights: uses insights
assistant/engine.py - Assistant interface → Puter transport: sends prompts
static/js/assistant.js - Puter transport → Model routing: gets model order
static/js/services/ai.js - Assistant interface → Local fallback: falls back locally
- Puter transport → Puter.js: calls models
README.md - Assistant interface → Result cache: caches conversation