TapeAgents

TapeAgents

TapeAgents is a framework that facilitates all stages of the LLM Agent development lifecycle

Stars: 194

Visit
 screenshot

TapeAgents is a framework that leverages a structured, replayable log of the agent session to facilitate all stages of the LLM Agent development lifecycle. The agent reasons by processing the tape and the LLM output to produce new thoughts, actions, control flow steps, and append them to the tape. Key features include building agents as low-level state machines or high-level multi-agent team configurations, debugging agents with TapeAgent studio or TapeBrowser apps, serving agents with response streaming, and optimizing agent configurations using successful tapes. The Tape-centric design of TapeAgents provides ultimate flexibility in project development, allowing access to tapes for making prompts, generating next steps, and controlling agent behavior.

README:

TapeAgents

PyPI - Version GitHub Release Documentation Paper Build Status Tests Status


TapeAgents Logo

TapeAgents is a framework that leverages a structured, replayable log (Tape) of the agent session to facilitate all stages of the LLM Agent development lifecycle. In TapeAgents, the agent reasons by processing the tape and the LLM output to produce new thoughts, actions, control flow steps and append them to the tape. The environment then reacts to the agent’s actions by likewise appending observation steps to the tape.

Why TapeAgents

Key features:

  • Build your agent as a low-level state machine, as a high-level multi-agent team configuration, or as a mono-agent guided by multiple prompts
  • Debug your agent with TapeAgent studio or TapeBrowser apps
  • Serve your agent with response streaming
  • Optimize your agent's configuration using successful tapes; finetune the LLM using revised tapes.

The Tape-centric design of TapeAgents will help you at all stages of your project:

  • Build with ultimate flexibility of having access to tape for making prompts and generating next steps
  • Change your prompts or team structure and resume the debug session as long as the new agent can continue from the older tape
  • Fully control the Agent's tape and the Agent's acting when you use a TapeAgent in an app
  • Optimize tapes and agents using the carefully crafted metadata structure that links together tapes, steps, llm calls and agent configurations

TapeAgents at a glance

TapeAgents Overview

Getting Started

Tutorial

Start with the introductory Jupyter notebook to quickly learn the core concepts of the framework.

Hello TapeAgents

The simplest agent just to show the basic structure of the agent:

from tapeagents.agent import Agent, Node
from tapeagents.core import Prompt
from tapeagents.dialog_tape import AssistantStep, UserStep, DialogTape
from tapeagents.llms import LLMStream, LiteLLM
from tapeagents.prompting import tape_to_messages

llm = LiteLLM(model_name="gpt-4o-mini")


class MainNode(Node):
    def make_prompt(self, agent: Agent, tape: DialogTape) -> Prompt:
        # Render the whole tape into the prompt, each step is converted to message
        return Prompt(messages=tape_to_messages(tape))

    def generate_steps(self, agent: Agent, tape: DialogTape, llm_stream: LLMStream):
        # Generate single tape step from the LLM output messages stream.
        yield AssistantStep(content=llm_stream.get_text())


agent = Agent[DialogTape].create(llm, nodes=[MainNode()])
start_tape = DialogTape(steps=[UserStep(content="Tell me about Montreal in 3 sentences")])
final_tape = agent.run(start_tape).get_final_tape()  # agent will start executing the first node
print(f"Final tape: {final_tape.model_dump_json(indent=2)}")

TapeAgents Examples

The examples/ directory contains examples of how to use the TapeAgents framework for building, debugging, serving and improving agents. Each example is a self-contained Python script (or module) that demonstrates how to use the framework to build an agent for a specific task:

Other notable examples that demonstrate the main aspects of the framework:

To run these examples, simply use:

uv run -m examples.<MODULE> <ARGS>

Installation

Install the latest release with its minimal dependencies:

pip install tapeagents

You can also install converters and finetune optional dependencies

pip install 'tapeagents[converters,finetune]'

Building from source

  1. Install uv to manage package:

Official documentation here

  1. Clone the repository:
git clone https://github.com/ServiceNow/TapeAgents.git
cd TapeAgents
  1. Create venv environment and install dependencies:
make setup
# equivalent to `uv sync --all-extras`

Learn more

See our full TapeAgents documentation.

For an in-depth understanding of the design principles, architecture, and research behind TapeAgents, see our technical report.

Contacts

Feel free to reach out to the team:

Acknowledgements

We acknowledge the inspiration we took from prior frameworks, in particular LangGraph, AutoGen, AIWaves Agents and DSPy.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for TapeAgents

Similar Open Source Tools

For similar tasks

For similar jobs