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:
Newer release available (0.11.2)

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.1.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.1-py3-none-any.whl (105.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for freeact-0.11.1.tar.gz
Algorithm Hash digest
SHA256 d0bd73168608d1c1233e79834fef1ed6fbdd47dee4b57f7da64f7f9023847113
MD5 20a26d568a1f0ef828da9364bb067837
BLAKE2b-256 e40399ee5f6b67268ae5e9282f47023bc75655f959d1729bf25fe2f9b01ff67f

See more details on using hashes here.

Provenance

The following attestation bundles were made for freeact-0.11.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: freeact-0.11.1-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.12

File hashes

Hashes for freeact-0.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ac1d3a00128511f96b97836266a745de43a0221f535fbcf50c479c987047198c
MD5 e4aa3c644ccedb07e5ae523f6aca486d
BLAKE2b-256 9bf6af86707256dd69135572d8be0df54d89713cb4bdb63d4e4a46b059bd56a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for freeact-0.11.1-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