Environments
Synthetic Environments / Long Horizon Tasks / Digital Control Agents

-98%25 (5 errors)-green)-98%25 (5 errors)-green)-98%25 (5 errors)-green)
-100%25 (0 errors)-green)-100%25 (0 errors)-green)-100%25 (0 errors)-green)

uvicorn src.synth_env.service.app:app --reload --port 8000 uv run python src/synth_env/examples/nethack/agent_demos/test_synth_react.py
Motivation
- We're building Environments to have key desiderata for long-horizon language agents
- Snapshotting and reproducibility
- Statefulness as a first-class citizen
- Consistent abstractions for engine interaction and state reads across settings
- Environment observability and tracing
- HTTP access for simplified training and evaluation
- Strong data abstractions to enable easily-configurable filtering and curriculum learning
- Simple abstractions for agent-originated tool edits, etc.
User Guide
Note - this repo is under extremely active development. Hic sunt dracones, if not contributing it may be more useful as a reference or development resource than as core code for your production systems.
Supported Environments
[] Sokoban (maturing, not active dev) - This environment is not of our own making! Please credit the great researchers at Deepmind and Ragen, among others. - Checkout test_synth_react.py for a hello world example! [] Hendryks Math [] (maturing) [] Crafter-Classic (maturing) [] EnronBench (active dev) [] SWE-Bench (active dev - do not attempt) [] NMMO (active dev - do not attempt) [] Red (active dev) [] Verilog (maturing)
...
Development
For development setup, testing, and contribution guidelines, see:
- Contributing Guide - Complete development setup and workflow
- Environment Contribution Guide - Step-by-step guide for adding new environments
Quick Development Commands
# Install dependencies
uv sync
# Run tests
./scripts/run_tests.sh
# Update README metrics
./scripts/run_dev_helpers.sh
# Format code
ruff format .
# Check codebase health
python scripts/check_health.py
# Release to PyPI (increment dev version)
python scripts/release.py
# Release with version selection
python scripts/release.py --minor
python scripts/release.py --patch
# Dry run to see what would happen
python scripts/release.py --dry-run
# Publish to TestPyPI instead
python scripts/release.py --test-pypi
Metadata
Release files for synth-env 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| synth_env-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / synth_env-0.1.0-py3-none-any.whl
| Download URL | synth_env-0.1.0-py3-none-any.whl |
|---|---|
| Size | 2.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
064b7a1e9f4b69b51d5f33a8eced419e88555be02b6bed41bae994482e512e67
|
|
BLAKE2b-256 checksum How to use checksums |
3e4328f1907f4b5caa9a6e883801e2337889f6d076411b5844145a5b163cb1b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.8
|
Security for synth-env 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.