A real agent to practise on
Everything a pip user needs is in the package: no repository checkout, no scripts. You add an LLM key.
tv practice-project
Writes a task project (as tv new task does) with the expense desk's 15 test cases, its Context answers, a docker-compose.yml and a .env whose test-control tokens are already made. An existing .env is never replaced.
The expense desk
A real LLM task agent: it reviews expense reports against the policy, approves, rejects, returns or escalates them, notifies employees and pays (finance only). Its image is published; any provider works: Azure OpenAI, OpenAI, Anthropic, Bedrock, Gemini, Ollama.
The recording proxy, in Docker
The Compose file builds tv proxy from this release on PyPI and puts it between the agent and its tools: the independent record of every call, and fault injection.
The onboarding guide
TruVelocity-Onboard-a-New-Agent.html, written into the project: install, start the agent, then each step with what to click, a screenshot and a test checklist, and how the same steps apply to your own agent, chatbot or workflow.
Planted defects
Set EXPENSE_DEFECTS in .env and restart: a wrong meal limit (REV-02), notices claimed but never stored (REV-01, 03, 04), a read that writes (seam SE-03). The verdict turns to No-go and Continuous lists 7 regressions.
Checked as a pip user
The guide was followed end to end from a wheel installed in a fresh environment, outside the repository: clean build Go, buggy build No-go, every screen as the guide shows it.
Found by onboarding a new agent
| Area | Change |
|---|---|
| Configure | A project made by tv new can pass the connection check: the starter lists its settings the way Configure reads them. |
| tv new | The starter's reset sends a token (TV_AGENT_RESET_TOKEN, in X-Sandbox-Token or the header you name); a task project takes its database (TV_AGENT_DB) and the tables to compare (TV_AGENT_TABLES, to leave out audit logs). |
| Context | Download the workbook gives the blank Context workbook to hand to an agent's owners. |
| Home | After a release decision the agent reads Decided: Go by <name> instead of Awaiting release decision; the greeting uses TV_UI_USER. |
| Conduct | The estimate counts the turns each wording really sends (19, not 48, for the practice catalog), and its timing is measured the same way, so it no longer reads "under a minute" for a run of two and a half. |
| Catalog | A catalog.yaml that doesn't load says so, and points to tv validate, instead of a blank page. |
| Uploads | An upload that is too large or refused is read in full before the answer, so the browser gets the reason instead of a connection reset on Windows. |
| tv practice-project | Says what to do when Docker isn't installed; the guide's "No Docker?" note points to Docker Desktop or the offline demo project. |
| Messages | Configure and Conduct no longer point at scripts that only exist in the repository. |
From install to a real agent
Install or upgrade
pip install -U "truvelocity-tevv[ui]"
Make the practice project
tv practice-project
Go into it
cd expense-desk-practice
Add your LLM key (the first block)
notepad .env
Start the agent (Docker Desktop)
docker compose up -d --wait
Open the UI and follow TruVelocity-Onboard-a-New-Agent.html
tv ui --allow-runs --open
No Docker or LLM at hand? tv demo-project still gives the offline demo.