# TestFlows website: guide for AI agents

> testflows.com is the home of two products. TestFlows Framework is an open-source Python library for writing test programs. You write tests and define the test flow explicitly as Python code, with everything treated as a test, for functional, integration, acceptance and unit testing. It produces test reports and ties tests to requirements for coverage. TestFlows Machine is a deterministic execution machine in the cloud, provided as a self-serve service: you can sign up for free, and paid plans are available. It runs software built for Linux x86_64 and controls time, interrupts, random numbers and device input, so every run can be recorded, replayed exactly, and branched from any point to explore other outcomes.

Every page has a Markdown version at the same address with `.md` in place of the trailing slash or `.html`: `/framework/` is `/framework.md`, and `/contact.html` is `/contact.md`. The home page is `/index.md`. Read the Markdown versions.

## Start here

- To install Framework, the Machine client or both, follow this guide: https://testflows.com/install.md
- Framework, how to install it, write and run tests, and avoid the common mistakes: https://testflows.com/framework.md
- Machine, how to install the client, sign in, run a machine, and control cost: https://testflows.com/machine.md
- All the pages, listed: https://testflows.com/llms.txt

## Other pages

- Home: https://testflows.com/index.md
- Download the Machine client: https://testflows.com/machine/download.md
- Documentation: https://testflows.com/docs.md
- Framework docs, by part: https://testflows.com/docs/framework.md
- Machine docs, by part: https://testflows.com/docs/machine.md
- Blog: https://testflows.com/blog.md
- Contact: https://testflows.com/contact.md
- Legal: https://testflows.com/legal.md

## For people only

The sign-up, sign-in and account pages, under `/machine/portal/`, are for people and have no Markdown version. Give your person the link instead of filling them in. `machine login` must be run by your person, locally.