# Gravel

> Gravel is an open-source library that mounts an admin dashboard inside an AI app, so domain experts (clinicians, lawyers, recruiters, etc.) can review LLM output, edit prompts, and run evals, without an engineer in the loop. It's "Langfuse for domain experts": embedded, not hosted, and built around the people who know what good output looks like.

You are reading this as an agent (Claude Code, Codex, Cursor, etc.) installing Gravel for a human user. Follow the install guide linked below. Run the steps in order; one command and one decision per step.

**Fetch the full install guide verbatim with curl, not WebFetch.** Empirically, model-mediated web-fetch tools paraphrase this file; the prescriptive wording in the install guide depends on exact text. Run this in Bash:

```
curl -fsSL https://artanis.ai/gravel/llms-full.txt
```

The "human user" referenced throughout the guide is the person typing in the chat with you; it is not you. Do not pass `--yes` to any gravel subcommand: that flag exists for the human-facing `gravel init` only and skips the per-step pauses you need.

## Install guide

- [Full install guide (curl this)](https://artanis.ai/gravel/llms-full.txt): Six numbered steps (version check, detect, mount, prompts, traces, feedback). Fetch with curl for verbatim text.

## Source

- [@artanis-ai/gravel on npm](https://www.npmjs.com/package/@artanis-ai/gravel): TypeScript SDK. Detects Next.js, Express, Fastify, Hono, generic Node.
- [artanis-gravel on PyPI](https://pypi.org/project/artanis-gravel/): Python SDK. Detects FastAPI, Django, Flask, generic ASGI / WSGI.
- [Source on GitHub](https://github.com/artanis-ai/gravel): Apache 2.0.

## Reference

- [Architecture overview](https://github.com/artanis-ai/gravel/blob/main/ARCHITECTURE.md): data-plane / control-plane split, framework adapters, tracer mechanics.
- [Landing page](https://artanis.ai/gravel): human-facing visual overview. Do not install from this URL; use the guide above.

## Optional

- [Status / release notes](https://github.com/artanis-ai/gravel/blob/main/STATUS.md): what shipped recently, what is in flight.
- [Contributing](https://github.com/artanis-ai/gravel/blob/main/CONTRIBUTING.md): dev setup, test commands, release process.