Skip to main content

Hierarchical agent loops with recursive self-organization.

Project description

fractal

license build docs lint tests codecov pre-commit

Hierarchical agent loops with recursive self-organization.

In a fractal, autonomous agent loops arrange themselves into a tree: a node iterates toward a goal in its own git worktree and spawns child nodes for separable subtasks, so the tree grows to fit the problem rather than a fixed plan. Hard caps (iterations, depth, children, cost, time) keep each loop bounded, and an operator can steer or stop it at any point. Run metadata (including cost) lands in one local SQLite database, which can be interacted with live in a terminal UI.


Source: https://github.com/plasma-ai/fractal

Package: https://pypi.org/project/plasma-fractal/

Documentation: https://docs.plasma.ai/fractal


This package is a pointer to plasma-fractal and contains no code. Each release pins the matching plasma-fractal release exactly, so the two names are interchangeable:

pip install fractal

installs plasma-fractal. Versions of fractal before 1.0.0 were an unrelated package from a previous owner of the name; the pointer begins at 1.0.0.

License

Licensed under the Apache License 2.0 — see LICENSE.

Copyright © 2026 Plasma AI

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fractal-1.0.0.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fractal-1.0.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file fractal-1.0.0.tar.gz.

File metadata

  • Download URL: fractal-1.0.0.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for fractal-1.0.0.tar.gz
Algorithm Hash digest
SHA256 31bf9b0455fb90f72f772ce49d540c4b8bb5eca3bc2d0c10b8bb4efdb3cad6ad
MD5 55702f76ec8bc8983a8311237d855e20
BLAKE2b-256 35387494cd83da098132141bd3d938a29dce50bdc6ea39f3c883f76443ff08f2

See more details on using hashes here.

Provenance

The following attestation bundles were made for fractal-1.0.0.tar.gz:

Publisher: build.yaml on plasma-ai/fractal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fractal-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: fractal-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for fractal-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4dab482efca33ae697d69aaec1b7240cdbad294a5499474e43ac8060929c7148
MD5 087a02536a2dffe60b5e8bb2a30f9e6b
BLAKE2b-256 ff06bbc08ee9ffef21e020611614be004399cae151143750441feda13f7f72a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for fractal-1.0.0-py3-none-any.whl:

Publisher: build.yaml on plasma-ai/fractal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page