AnkTechsol / AnkTechsol/Satya_AI
[good first issue] Add one-click "Inbox Triage" demo project for Satya
- Dominant language
- Python
- Stars
- 8
- Forks
- 6
- PR merge metrics
- No merged PRs in 30d
Description
The Satya_AI repository would benefit from a **ready-to-run demo project** that tells a clear story: an "Inbox Triage Agent" processing tasks while a human observes progress in the Satya dashboard. This takes the existing examples idea further by giving new users a single narrative demo they can run in under 2 minutes. [page:12][page:13]
Task
----
Create a demo project that demonstrates:
1. **Inbox Triage Scenario** – A Python script that:
- registers an `inbox_triage_agent`
- creates a batch of "email" or "ticket" tasks (e.g., low/medium/high priority)
- logs progress as the agent "triages" them over time
2. **Pre-populated Demo Data** – A helper script (e.g. `examples/inbox_triage/bootstrap_demo.py`) that:
- seeds realistic tasks into the Satya store (flat files / SQLite)
- sets basic metadata (priority, tags, timestamps) so the dashboard looks "alive" on first run
3. **Dashboard Walkthrough** – Update docs to show:
- how to run the demo script
- how to open the Streamlit dashboard and filter tasks for this agent
- what to look for (status changes, audit events, etc.) [page:12]
Implementation Steps
--------------------
- [ ] Create `examples/inbox_triage/` directory
- [ ] Add `bootstrap_demo.py` that seeds demo tasks and events
- [ ] Add a main script (e.g. `run_demo.py`) that simulates the agent updating task states
- [ ] Add a short `README.md` in `examples/inbox_triage/` explaining how to run the demo
- [ ] Add a section in the main `README.md` linking to the "Inbox Triage" demo
Resources
---------
- • Existing examples issue and implementation (#157, #161) for structure inspiration
- • SDK reference and dashboard code in this repo
Why This Matters
----------------
A one-click, story-driven demo makes it *much* easier for new users to see Satya's value immediately and is ideal for workshops, talks, and quick product demos. This is a great first contribution for anyone enjoying DX and examples!
Contributor guide
Assessment
This issue has not been assessed yet.