freeact

freeact

Website PyPI - Version GitHub Release GitHub Actions Workflow Status GitHub License

General-purpose AI agent that acts via code actions through a unified execution interface.

Overview

Freeact is a lightweight, general-purpose agent that acts via code actions in a stateful execution environment provided by ipybox. A unified execution interface allows code actions to contain any combination of Python code, shell commands, and programmatic MCP tool calls, generated in one LLM inference pass.

For programmatic MCP tool calling ("code mode"), freeact generates typed Python APIs from MCP server schemas. The agent inspects generated APIs prior to execution and composes them within code actions based on available type information. Successful code actions can be saved as reusable tools, capturing agent experience as executable knowledge, optionally combined with agent skills.

Freeact supports tool discovery via agentic and semantic search, loading only task-relevant tool information into the context window. It can enforce application-level approval of code actions, shell commands, and programmatic tool calls, originating from both main agents and subagents. Freeact runs locally on your computer and is available as a CLI tool and Python SDK.

[!NOTE] Supported models: Freeact supports any model compatible with Pydantic AI. See Configure models for provider configuration and examples.

Documentation

Capabilities

Capability Description
Unified execution Freeact agents act by executing Python code, shell commands, and programmatic MCP tool calls. These can be combined within a code action, generated in a single inference pass.
Action approval Application-level approval of code actions, shell commands, and programmatic tool calls originating from both main agents and subagents.
MCP code mode Freeact calls MCP server tools programmatically1) via generated Python APIs. This enables composition of tool calls and intermediate result processing in code actions, reducing LLM roundtrips.
Local execution Freeact executes code and shell commands locally in an IPython kernel provided by ipybox. Data, configuration, and generated tools live in local workspaces.
Sandbox mode IPython kernels optionally run in a sandbox environment based on Anthropic's sandbox-runtime, enforcing filesystem and network restrictions at OS level.
Tool discovery Tools are discovered via category browsing or hybrid BM25/vector search. On-demand loading frees the context window and scales to larger tool libraries.
Subagent delegation Tasks can be delegated to subagents, each using their own execution environment. This enables specialization and parallelization without cluttering the main agent's context.
Agent skills agentskills.io-based skills add specialized knowledge and workflows, composing naturally with code actions and agent-authored tools.
Tool authoring Agents can create new tools, enhance existing tools, and save code actions as reusable tools. This captures agent experiences as executable knowledge.
Session persistence Freeact persists agent state incrementally. Persisted sessions can be resumed and serve as a record for debugging, evaluation, and improvement.

Usage

Component Description
Agent SDK Agent harness and Python API for building freeact applications.
CLI tool Terminal interface for interactive conversations with a freeact agent.

1) Freeact also supports MCP server integration via JSON tool calling, but the recommended approach is programmatic tool calling.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for cstub from gravatar.com cstub Avatar for krasserm from gravatar.com krasserm

Credits

Author: Martin Krasser

License expression

Apache-2.0
View SPDX License List

Requires

Python <3.15, >=3.13

Provides Extra

search

Report project as malware

Download files

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

Source Distribution

freeact-0.11.2.tar.gz (79.1 kB view details)

Uploaded Source

Built Distribution

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

freeact-0.11.2-py3-none-any.whl (105.3 kB view details)

Uploaded Python 3

File details

Details for the file freeact-0.11.2.tar.gz.

File metadata

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

File hashes

Hashes for freeact-0.11.2.tar.gz
Algorithm Hash digest
SHA256 804403dfae808f1253b0629762487359a15a51569c43ed9d6b8a61361f4a71e2
MD5 33d9829f3d523365b3f59d713a714d1c
BLAKE2b-256 c65f73a34c63dc4121258c852f66803cee733bcc95cf2011312288edb78e4e33

See more details on using hashes here.

Provenance

The following attestation bundles were made for freeact-0.11.2.tar.gz:

Publisher: release.yml on gradion-ai/freeact

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

File details

Details for the file freeact-0.11.2-py3-none-any.whl.

File metadata

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

File hashes

Hashes for freeact-0.11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dfafaecc8e57373bd4bdcdbce49e2a8b53ffd7a56b4e1f9308d4a00bd967cb1a
MD5 865da0403b3f8971e1e1b3db1d73b573
BLAKE2b-256 3954d091a9a0312e111facbefb4c9d4c8e9d6974055699346811299473683b21

See more details on using hashes here.

Provenance

The following attestation bundles were made for freeact-0.11.2-py3-none-any.whl:

Publisher: release.yml on gradion-ai/freeact

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 Sentry Error logging StatusPage Status page