AGEX AI Agent

An extensible AI agent that connects LLMs to modular Python tools, making it easy to add, modify, and remove capabilities.

Get Started Explore Features

@tool_registry.register(
    name="calculator",
    description="Safely evaluate mathematical expressions"
)
def calculator(expression):
    return eval(expression)

Key Features

Backup Models

Automatically switches to configured backup models when the primary model or other backups exhaust their usage limits without disturbing the loop. Configure as many backups as needed.

Local Backup

If all configured backup models exhaust their usage limits, a local model continues the work (server must be already running).

TPM Limit Detection

Detects TPM/RPM rate limits, waits 60 seconds, and retries the request automatically without interrupting the model (5 retries).

Additional Features

Local AI Inference

Connect to locally hosted language models through an OpenAI-compatible API for private, offline inference.

Tool Calling

Allow the model to request Python functions to perform tasks autonomously.

Modular Tool System

Configurable Models

Configure the model endpoint and model name through environment variables.

Builtin Tools

Calculator

Safely evaluate mathematical expressions using basic arithmetic operators.

Web Search

Search the web and return relevant results with titles and URLs.

Website Reader

Fetch webpages and extract readable text for the AI to analyse.

Link Finder

Find links on a webpage and convert relative URLs into absolute URLs.

File Reader

Read the contents of local files.

File Writer

Create files or overwrite existing files after user confirmation.

File Editor

Replace a unique piece of text in an existing file, preview changes, and request user confirmation.

Directory Listing

List files and directories at a specified path.

Shell Execution

Execute shell commands on the host computer with configurable timeout and output limits.

Playwright

Use the Playwright tools to view, explore and debug websites.

Setup

Clone the Repository

Clone the AGEX repository to your local machine.

Windows git clone https://github.com/noahdeangelis/AGEX.git

Linux git clone https://github.com/noahdeangelis/AGEX.git

Create Virtual Environment

Set up a Python virtual environment for isolated dependencies.

Windows python -m venv .venv

Linux python3 -m venv .venv

Activate Virtual Environment

Set up a Python virtual environment for isolated dependencies.

Windows .venv\Scripts\Activate.ps1

Linux source .venv/bin/activate

Install Dependencies

Install the core dependencies using pip.

Windows pip install -r requirements.txt

Linux pip install -r requirements.txt

Configure Environment

Create a .env file and configure your model settings.

Windows copy .env.example .env

Linux cp .env.example .env

Commands

/quit

Exit the program

/exit

Exit the program

/clear

Clear the terminal

/model

Switch between Primary, Backups and Local on the fly

/build [task]

Build, run, and test full apps by itself

/new

Start a new conversation while preserving existing saved chats.

/chats

View saved conversations and select one to continue.

/resume [id]

Resume a saved conversation by its chat ID, restoring its message history.