# freeact

> Freeact code action agent

Freeact is a lightweight agent that acts by executing Python code and shell commands.
Code actions are key for an agent to improve its own tool library and codebase.

Freeact has a tiny core, a small system prompt, and is extensible with agent skills.
It relies on a minimal set of generic tools: read, write, execute, subagent, and tool search.

Code and shell command execution runs locally in a stateful, sandboxed environment.
Freeact supports utilization of MCP servers by generating Python APIs for their tools.


## User Guide

- [Overview](https://gradion-ai.github.io/freeact/index.md): Overview, usage, and 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
- [Code Execution](https://gradion-ai.github.io/freeact/execution/index.md): Code and shell command execution in IPython kernels
- [Sandbox Mode](https://gradion-ai.github.io/freeact/sandbox/index.md): Sandbox mode for code execution and MCP servers
- [Models](https://gradion-ai.github.io/freeact/models/index.md): Model configuration, provider settings, and custom providers
- [Agent SDK](https://gradion-ai.github.io/freeact/sdk/index.md): Agent 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