# Arya

> Arya learns how you shop from your receipts and helps shoppers help each other.

## Start here

- [For judges](https://docs.arya.teamnightshift.org/docs/judges): One page for judges: how Arya fits the problem statement and the Indie track, impact, Meta model use, technical depth, the demo, and limits.
- [8-minute demo path](https://docs.arya.teamnightshift.org/docs/quest/judge-playbook): An eight-minute walk through the live demo, step by step, with what you see and which model is working.
- [What is Arya](https://docs.arya.teamnightshift.org/docs/intro): What Arya is, how it works end to end, and which Meta model does which job.
- [Built in the hackathon window](https://docs.arya.teamnightshift.org/docs/what-we-built): What existed before the hackathon window, what was built in it and when, from git history.
- [Why Arya exists](https://docs.arya.teamnightshift.org/docs/principles): Why Arya exists, who it is for, and the five principles behind it.

## Using Arya

- [User journeys](https://docs.arya.teamnightshift.org/docs/guide/user-journeys): Seven user journeys, from the first receipt to a shared household, with screens and sample data.
- [Quest overview](https://docs.arya.teamnightshift.org/docs/quest/overview): Quest, the optional game layer that turns a store trip into a hunt for list items.
- [Quest game design](https://docs.arya.teamnightshift.org/docs/quest/game-design): The design of the Quest hunt: rules, rewards, sound, and offline behaviour.
- [Map my store](https://docs.arya.teamnightshift.org/docs/quest/map-my-store): How shoppers map a store aisle by aisle, and how maps merge across shoppers.
- [Use Arya in Muse](https://docs.arya.teamnightshift.org/docs/guide/agent-connector): How to use Arya from Muse and other AI agents over MCP, with a secure vault for access.
- [Glossary](https://docs.arya.teamnightshift.org/docs/glossary): Plain-language definitions of the words Arya uses.

## How it is built

- [Design decisions and what is next](https://docs.arya.teamnightshift.org/docs/architecture/design-decisions): What is built, what is known to be weak, and the plan to grow past one server.
- [Architecture](https://docs.arya.teamnightshift.org/docs/architecture/overview): How the app runs: the one-page map, storage, models, sync, security, and the design record.
- [Scalability design](https://docs.arya.teamnightshift.org/docs/architecture/scalability): A nine-phase plan for growing beyond one process, with rollback and a measure for each phase.
- [Model policy](https://docs.arya.teamnightshift.org/docs/architecture/model-policy): Which model runs each job, how the cheapest model that passes its test is chosen, and the spend limits.
- [Meta products in the code](https://docs.arya.teamnightshift.org/docs/quest/meta-products): Each Meta product Arya uses, its job, and where it sits in the code.
- [Meta models used and not used](https://docs.arya.teamnightshift.org/docs/architecture/models): Every Meta model on offer: the ones Arya uses, the ones it does not, and why.
- [How we built it](https://docs.arya.teamnightshift.org/docs/internal/index): How Arya was built by one person working with a team of AI agents, each with one job.

## Evidence

- [Overview](https://docs.arya.teamnightshift.org/docs/evals/index): Index of the measured results, with the files behind each number.
- [Gate 0 report](https://docs.arya.teamnightshift.org/docs/evals/gate-0): The first test of Muse Spark reading receipt photos, with settings and results.
- [Wonder eval](https://docs.arya.teamnightshift.org/docs/evals/wonder-eval): How well Muse Wonder read the public receipt photos, line by line.
- [Staple judge eval](https://docs.arya.teamnightshift.org/docs/evals/judge-eval): How well the staple judge picks items to suggest, against a purchase-cadence check.

## Developers

- [Run it yourself](https://docs.arya.teamnightshift.org/docs/run-it-yourself): How to run Arya on your own computer with Docker and your own Meta API key.
- [Tour of your own copy](https://docs.arya.teamnightshift.org/docs/try-the-features): A guided tour of the features on your own copy.
- [Lists API v1](https://docs.arya.teamnightshift.org/docs/api/lists-api): Read and write your own Arya lists from another app or a script (Lists API v1).

## After the hackathon

- [Roadmap](https://docs.arya.teamnightshift.org/docs/roadmap): Ideas for where Arya could go after the hackathon; not commitments.