AnkTechsol / AnkTechsol/Satya_AI

[good first issue] Add one-click "Inbox Triage" demo project for Satya

Open
#162 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.