GitHub links require repository access.

# SAGA

SAGA turns public haemophilia updates into short, source-linked briefs for human review.
Each brief explains what changed, why it may matter, who should review it, and a possible next step.

Built by Team Codechondria, Amity University, Bengaluru, for the Novo Nordisk GBS Hackathon 2026.

## Start here

- [Open the live demo](https://saga-codechondria-82dbcf.centralindia.cloudapp.azure.com). No sign-in or installation
- [Start the guided walkthrough](https://saga-codechondria-82dbcf.centralindia.cloudapp.azure.com/workspace#demo)
- [Presentation](https://github.com/wysh3/saga/blob/main/artifacts/submission/SAGA-final-readout.pptx) · [PDF](https://github.com/wysh3/saga/blob/main/artifacts/submission/SAGA-final-readout.pdf)
- [Watch the demo (2:55)](https://saga-codechondria-82dbcf.centralindia.cloudapp.azure.com/backend/api/submission/SAGA-walkthrough.mp4) · [Demo guide](https://github.com/wysh3/saga/blob/main/docs/demo.md)
- [Technical review and app download](https://saga-codechondria-82dbcf.centralindia.cloudapp.azure.com/project). Source and classifier included

## Run locally

Install Docker Compose, [uv](https://docs.astral.sh/uv/) and OpenSSL.
Extract the app download, then run:

```sh
cd SAGA/source
./scripts/setup_developer.sh
```

Open [localhost:3000](http://localhost:3000). Initial setup needs internet; replay needs no provider key.
For a Git clone, the same script downloads the model through an authenticated GitHub CLI.

## How it works

A local classifier sorts records. A language model drafts briefs. Evidence checks, routing rules
and human review control what appears. The demo uses public records and clearly marked synthetic
examples. Its results show the workflow; human usefulness and time savings still need a pilot.

Category accuracy was 92.41% versus the keyword baseline's 55.70% on 79 AI-labelled records. Source-change detection tied its rules baseline. Safety recall was 2/5; see [Results](https://github.com/wysh3/saga/blob/main/docs/evaluation.md).

## Guides

[Architecture](https://github.com/wysh3/saga/blob/main/docs/architecture.md) · [Results](https://github.com/wysh3/saga/blob/main/docs/evaluation.md) · [Models](https://github.com/wysh3/saga/blob/main/docs/models.md) ·
[Data](https://github.com/wysh3/saga/blob/main/docs/data.md) · [Sources](https://github.com/wysh3/saga/blob/main/docs/sources.md) · [Pilot](https://github.com/wysh3/saga/blob/main/docs/pilot.md) ·
[Operations](https://github.com/wysh3/saga/blob/main/docs/operations.md) · [Development](https://github.com/wysh3/saga/blob/main/docs/development.md)

Code is in `src/saga/` and `web/`; tests are in `tests/`.
The repository is private. GitHub links require access.

For product context, see [existing approaches and SAGA’s focus](https://github.com/wysh3/saga/blob/main/docs/pilot.md#existing-approaches-and-sagas-focus). The comparison distinguishes published vendor capabilities from our own measured baseline results.
