Metadata-Version: 2.4
Name: orcraft
Version: 1.1.2
Summary: Orcraft - the platform for test development and orchestration that lets you and your AI agents run the entire testing operation
Author-email: "GM Core Ltd." <support@orcraft.app>
Maintainer-email: "GM Core Ltd." <support@orcraft.app>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://orcraft.app
Project-URL: Documentation, https://orcraft.app/setup/getting-started/
Project-URL: Changelog, https://orcraft.app/setup/releases/
Project-URL: Releases, https://github.com/GMCoreAI/orcraft/releases
Project-URL: Publisher, https://gmcore.ai/
Keywords: orcraft,test-orchestration,test-automation,validation,distributed-testing,ai-agents
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: THIRD-PARTY-NOTICES
Requires-Dist: certifi<2027,>=2026.10.23
Requires-Dist: cryptography<51,>=50.0.2
Requires-Dist: grpcio<2,>=1.85.0
Requires-Dist: protobuf<8,>=7.36.2
Requires-Dist: PySide6<7,>=6.12.0
Dynamic: license-file

# Orcraft

Orcraft is the platform for test development and orchestration that lets you and your AI agents run the entire testing operation.

A plain-Python test framework gives suites a defined structure. A controller runs those suites from a GUI, the command line or a CI pipeline and collects the logs and results in one place. An endpoint application on each test machine lets the controller run tests there, so a run covers the local machine or a fleet of remote machines with the same suites.

Your AI agents work across all of them. They write suites in the framework's structure, run them on the machines registered in the controller and read the logs the runs leave behind. The person decides what to test, reviews what the AI agents wrote in the controller GUI, runs it and corrects it, unless the whole loop is handed to the AI agents and runs fully automated.

## The package

This package installs the controller, the endpoint application and the test framework:

- `orcraft-controller run` starts the [controller](https://orcraft.app/setup/getting-started/), with its GUI or on the command line.
- `orcraft-endpoint run` starts the [endpoint application](https://orcraft.app/setup/endpoints/) on a test machine.
- `from orcraft import ...` gives a suite the [framework](https://orcraft.app/framework/).

It runs on Windows, Linux and macOS and needs Python 3.14 or newer.

## Installation

```console
pip install orcraft
```

Installing into a virtual environment is recommended, and required on distributions that protect the system Python. The [Prerequisites](https://orcraft.app/setup/prerequisites/) page covers Python, the virtual environment and the GUI's requirements per operating system.

## First steps

- [Orcraft's Web Site](https://orcraft.app): what Orcraft is and its documentation.
- [Watch the demo](https://orcraft.app/demo/): see Orcraft in action.
- [Getting started](https://orcraft.app/setup/getting-started/): install the controller and run the first test.
- [Adding endpoints](https://orcraft.app/setup/endpoints/): run the endpoint application on your machines and register them in the controller.
- [Tutorial](https://orcraft.app/tutorial/): the framework, one feature at a time, with a suite you can run.
- [Framework reference](https://orcraft.app/framework/): every class, field and status of the framework.

## Support

Ask any question, report an issue, request a feature: support@orcraft.app.

## License

© 2026 GM Core Ltd. All rights reserved.
The Orcraft software is provided under the Orcraft Software License Agreement in `LICENSE`; its source code is proprietary. The notices of the third-party software it includes are in `THIRD-PARTY-NOTICES`.
Orcraft™ is a trademark of GM Core Ltd. The Orcraft name, logo and branding assets are proprietary and may not be used without prior written permission.

## Website

https://orcraft.app
