Skip to main content

fractale agents

Agents to use with fractale, agentic state-machine orchestrator for Science

PyPI version DOI

https://github.com/converged-computing/fractale/raw/main/img/fractale-small.png

A sub-agent is a single step in a state machine that can call other sub-agents, tools, or prompts, and respond dynamically to work on a scoped task. Sub-agents are created in order to map our expertise and logic into a more controlled execution or interaction with an LLM.

Agents

The following agents are availble.

Name Description Path
flux-operator expert to deploy Flux Operator MiniClusters to Kubernetes fractale_agents.kubernetes.FluxOperatorAgent
flux-build optimized to build containers for the Flux Operator fractale_agents.kubernetes.FluxBuildAgent
result_parse Parse specific metrics from output logs fractale_agents.parsers.ResultParserAgent
optimize General optimization agent fractale_agents.optimize.OptimizeAgent
job-transform Job specification transformation agent fractale_agents.hpc.job.JobTransformAgent
job-generate Job specification generation agent fractale_agents.hpc.job.JobGenerationAgent

The general prompt agent is provisioned by fractale directly, fractale.agents.general.PromptAgent. Would you like to see an expert added? Please open an issue and let us know.

Usage

A sub-agent is a specialized expert that can be imported and used in a fractale workflow. You can register agents on the fly, or via a configuration file.

# Register a sub-agent tool on the fly
fractale prompt -t fractale_agents.kubernetes.FluxOperatorAgent Deploy lammps to Kubernetes using the Flux Operator

Or write the tool into a registry file:

# sub-agents.yaml
tools:
  - path: fractale_agents.kubernetes.FluxOperatorAgent

And then:

fractale prompt -r ./sub-agents.yaml Deploy lammps to Kubernetes using the Flux Operator

The agents have logical dependencies. For example, the flux-operator sub agent is expecting to have access to a Kubernetes cluster to install and use the Flux Operator!

License

HPCIC DevTools is distributed under the terms of the MIT license. All new contributions must be made under this license.

See LICENSE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (MIT)

LLNL-CODE- 842614

Metadata

Release files for fractale-agents 0.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fractale-agents 0.0.13
File Size Uploaded
fractale_agents-0.0.13.tar.gz 33.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fractale-agents 0.0.13
File Interpreter ABI Platform
fractale_agents-0.0.13-py3-none-any.whl Python 3 none any Details

Total release size: 76.1 kB

Release files / fractale_agents-0.0.13.tar.gz

Download URL fractale_agents-0.0.13.tar.gz
Size 33.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3e051c68e7a227036856e1fff7bd170b39443ca9a275f21d266267a48e98bbf0
BLAKE2b-256 checksum
How to use checksums
b3fa61be013ac2163b757b605f4dc439675a0a61c76d6caeeaf3a150f1118c1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Release files / fractale_agents-0.0.13-py3-none-any.whl

Download URL fractale_agents-0.0.13-py3-none-any.whl
Size 42.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0e56a7d972e4df43bfaf47463a6d0eb4f26113e13f619e922f7890474ba1d90d
BLAKE2b-256 checksum
How to use checksums
816a3c34eb46b54baf36f02240ebdfa87b912c3b2bd164df17d48954695e1691
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Release history Release notifications | RSS feed

This release

0.0.13 This release

2 release files

0.0.12

2 release files

0.0.1

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page