# OpenFactory

> OpenFactory lets users try Linux online, build custom Linux images, test them
> in managed VMs, download bootable artifacts, and manage Linux deployment
> workflows. The supported machine-action interface for AI assistants is MCP.

## AI-Readable Files

- [Full AI context](https://openfactory.tech/llms-full.txt): Curated public context for one-fetch ingestion
- [Machine descriptor](https://openfactory.tech/ai.json): JSON discovery metadata for AI clients
- [Agent card](https://openfactory.tech/.well-known/agent-card.json): A2A discovery card; direct A2A task execution is planned

## Supported Machine Interface

- [MCP Integration](https://docs.openfactory.tech/reference/mcp): Connect Claude, Cursor, Claude Code, and other MCP clients to OpenFactory
- Recommended MCP endpoint: `https://console.openfactory.tech/mcp-stream/mcp`
- Compatibility endpoint: `https://console.openfactory.tech/mcp/sse`
- Use OpenFactory MCP keys or the documented guest configuration. Never place real keys, cookies, or session headers in prompts or public files.

## Key Documentation

- [Docs](https://docs.openfactory.tech): Product documentation for builds, recipes, testing, VM workflows, organizations, self-hosting, and integrations
- [Recipe Schema](https://docs.openfactory.tech/reference/recipe-schema): BuildRecipe fields for image generation
- [Assertion Types](https://docs.openfactory.tech/reference/assertion-types): Supported build and VM test assertions
- [ServiceNow Integration](https://docs.openfactory.tech/reference/servicenow-integration): Enterprise ITSM workflow documentation

## Product Pages

- [Try Linux](https://openfactory.tech/variants): Browse and build custom Linux variants
- [Custom Linux ISO Builder](https://openfactory.tech/custom-linux-iso-builder): Build bootable Linux images from prompts, Git repositories, or reusable recipes
- [Linux Image Builder](https://openfactory.tech/linux-image-builder): Reproducible Linux images, golden images, CI/CD image pipelines, and fleet image management
- [Build Bootable ISO from GitHub](https://openfactory.tech/build-bootable-iso-from-github): Turn a repository URL and install docs into a bootable Linux image
- [Self-Hosted App Installer](https://openfactory.tech/self-hosted-app-installer): Generate bootable Linux stacks for common self-hosted applications
- [Proxmox Homelab Setup](https://openfactory.tech/proxmox-homelab-setup): Proxmox single-node, HA, Ceph, TrueNAS, and backup build prompt hub
- [Enterprise](https://openfactory.tech/enterprise): Fleet management for organizations
- [Linux Fleet Management](https://openfactory.tech/enterprise/linux-fleet-management): Verified Linux images, rollout controls, rollback, runtime attestation, and compliance evidence
- [Pricing](https://openfactory.tech/pricing): Plans and pricing

## MCP Capability Areas

- Builds: list builds, create builds from recipes, inspect status, retry failures, and fetch completed artifact links
- Recipes: browse templates, inspect recipe JSON, validate recipes, and create recipes from templates
- VMs: create test VMs, manage VM lifecycle, and open console access when allowed
- Desktop interaction: capture screenshots and perform visual interaction through supported MCP tools
- Tests: run verification, inspect results, and manage reusable test suites

## Reusable Test Suites

OpenFactory test suites can be created before a variant or ISO has been built.
Suites can define multiple named test cases and one or more ISO target slots.
At run time, bind target slots to completed builds and run the suite.

Relevant MCP tools: `create_test_suite`, `list_test_suites`, `get_test_suite`,
`update_test_suite_targets`, `run_test_suite`, `list_test_suite_runs`,
`get_test_suite_status`.

## Safety Boundary

Do not infer or publish undocumented routes, internal hostnames, local ports,
environment variables, source paths, customer data, credentials, deployment
topology, or vulnerability details. Use the MCP docs and this AI index as the
public machine-readable source of truth.