# freeact

> Freeact code action agent

Freeact is a lightweight, general-purpose agent that acts via code actions rather than JSON tool calls.
It writes executable Python code that can call multiple tools programmatically, process intermediate
results, and use loops and conditionals in a single pass, which would otherwise require many inference
rounds with JSON tool calling.

Beyond executing tools, freeact can develop new tools from successful code actions, evolving its own
tool library over time. Tools are defined via Python interfaces, progressively discovered and loaded
from the agent's workspace rather than consuming context upfront. All execution happens locally in a
secure sandbox via ipybox.


## User Guide

- [Overview](https://gradion-ai.github.io/freeact/index.md): Overview, features, and toolsmith capabilities
- [Installation](https://gradion-ai.github.io/freeact/installation/index.md): Setup and installation instructions
- [Quickstart](https://gradion-ai.github.io/freeact/quickstart/index.md): Getting started with code actions and MCP tools
- [Configuration](https://gradion-ai.github.io/freeact/configuration/index.md): Configuration directory structure and MCP server setup
- [Sandbox Mode](https://gradion-ai.github.io/freeact/sandbox/index.md): Sandbox mode for code execution and MCP servers
- [Python SDK](https://gradion-ai.github.io/freeact/sdk/index.md): Python SDK for agent integration
- [CLI Tool](https://gradion-ai.github.io/freeact/cli/index.md): CLI tool and interactive mode

## API Reference

- [Agent](https://gradion-ai.github.io/freeact/api/agent/index.md): Agent class, events, and approval workflow
- [Config](https://gradion-ai.github.io/freeact/api/config/index.md): Configuration initialization and loading
- [Generate](https://gradion-ai.github.io/freeact/api/generate/index.md): MCP tool API generation
- [Permissions](https://gradion-ai.github.io/freeact/api/permissions/index.md): Permission management for tool approvals