Archytas: A Tools Interface for AI Agents

Implementation of the ReAct (Reason & Action) framework for Large Language Model (LLM) agents. Extensible to a variety of LLMs and LLM providers.

Easily create tools from simple python functions or classes with the @tool decorator. A tools list can then be passed to the ReActAgent which will automagically generate a prompt for the LLM containing usage instructions for each tool, as well as manage the ReAct decision loop while the LLM performs its task.

Tools can be anything from internet searches to custom interpreters for your domain. Archytas provides a few built-in demo tools e.g. datetime, fibonacci numbers, and a simple calculator.

Demos

Short demo of using the PythonTool to download a COVID-19 dataset, and perform some basic processing/visualization/analysis/etc.

Watch the video
click to watch original video on youtube

MCP Demos

# Install with MCP support (includes langchain-mcp-adapters + fastmcp)
uv pip install -e ".[mcp]"

# Vision demo with local MCP server
python demos/demo_mcp_vision.py

# External MCP server (DuckDuckGo search via npx)
python demos/demo_mcp_duckduckgo.py

# HTTP MCP server (Context7 - requires API key)
export CONTEXT7_API_KEY="your-api-key"
python demos/demo_mcp_context7.py

To use mcp tools with archytas, you will need to install the optional deps uv pip install -e ".[mcp]"

Read the mcp quick start doc for more info

Quickstart

# clone and install
git clone git@github.com:jataware/archytas.git
cd archytas
uv pip install -e .

# make sure OPENAI_API_KEY var is set
# or pass it in as an argument to the agent
export OPENAI_API_KEY="sk-..."

# run demo
uv run chat-repl

Simple Usage

Import pre-made tools from the tools module

from archytas.react import ReActAgent, FailedTaskError
from archytas.tools import PythonTool

from easyrepl import REPL

# create the agent with the tools list or a `custom_prelude` (if desired)
some_tools = [PythonTool, ..., etc.]
agent = ReActAgent(tools=some_tools, verbose=True)

# REPL to interact with agent
for query in REPL():
    try:
        answer = agent.react(query)
        print(answer)
    except FailedTaskError as e:
        print(f"Error: {e}")

Documentation

See the wiki docs for details.

Project links

Data verified by PyPI on Jul 29, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

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

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for david-andrew from gravatar.com david-andrew Avatar for fivegrant from gravatar.com fivegrant Avatar for mattprintz from gravatar.com mattprintz

Credits

Author: David Andrew Samson

GitHub Statistics

Data verified by PyPI on Jul 29, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GPL-3.0-or-later

Requires

Python >=3.10

Provides Extra

dev testing

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

archytas-2.0.7.tar.gz (87.9 kB view details)

Uploaded Source

Built Distribution

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

archytas-2.0.7-py3-none-any.whl (103.0 kB view details)

Uploaded Python 3

File details

Details for the file archytas-2.0.7.tar.gz.

File metadata

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

File hashes

Hashes for archytas-2.0.7.tar.gz
Algorithm Hash digest
SHA256 ebe74e49c840c0282f7c80faaa20258ea999ee6c2d2e64b6d639fa594a8b3430
MD5 ac320b4cb9cad4d11d6a24bd9ad0c210
BLAKE2b-256 3e41d0ff6b5e1a8921d84caecb853ac7c02fac8471ec3c544afa07093b87c0b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for archytas-2.0.7.tar.gz:

Publisher: publish.yml on jataware/archytas

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

File details

Details for the file archytas-2.0.7-py3-none-any.whl.

File metadata

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

File hashes

Hashes for archytas-2.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 b2bef99c41597dfd764296bc0c9e7d3b6d987d12b632e6a8fff8ff879b08e9ff
MD5 11b40388f32680349d189c7330bbd823
BLAKE2b-256 8411da230e306d8f04687486a76bb5d526883ff47465d07b0644ba4ee2f565c6

See more details on using hashes here.

Provenance

The following attestation bundles were made for archytas-2.0.7-py3-none-any.whl:

Publisher: publish.yml on jataware/archytas

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

Release history Release notifications | RSS feed

This release

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1 yanked

2.0.0

2.0.0b1 pre-release

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.2rc1 pre-release

1.5.1

1.5.0

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.19 yanked

Reason this release was yanked:

This is a breaking change, should have bumped the minor version.

1.3.18

1.3.17

1.3.16

1.3.15

1.3.14

1.3.13

1.3.12

1.3.11

1.3.10

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.3

1.2.2

1.2.1

1.2.0

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

0.3.0

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page