Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 26 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,13 @@ AgentStack scaffolds your _agent stack_ - the tech stack that collectively is yo
<img src='https://github.com/AgentOps-AI/AgentStack/blob/7b40e53bf7300f69e3291c62d5b45e46ff818245/docs/images/the_agent_stack.png?raw=true' width='600' alt='agentstack init'>
</p>

### Currently Supported Providers
- **LLMs**: Most all notable LLMs and providers are supported via LiteLLM or LangChain
- **Framework**: Currently supported frameworks include CrewAI and LangGraph
- Roadmap: Pydantic AI, Eliza, AG2 and Autogen
- **Tools**: Maintaining the largest repository of framework-agnostic tools! All tools listed [here](https://docs.agentstack.sh/tools/community)
- **Observability**: AgentOps baked in by default with first-tier support

### Get Started Immediately

You **don't** need to install or configure tools like LangChain or LlamaIndex.<br>
Expand All @@ -44,7 +51,7 @@ Create a project, and you're good to go.
To create a new agent project, run:

```sh
pip install agentstack
uv pip install agentstack
agentstack init <project_name>
```

Expand All @@ -56,10 +63,17 @@ Once the initialization is done, you can open your project folder:

```sh
cd <your_agent_project>
uv pip install
```

then run the default agent!

```sh
agentstack run
```

### Templates
Additionally, pre-built templates are available as a shortcut to building your project. [View the available templates]().
Additionally, pre-built templates are available as a shortcut to building your project. [View the available templates](https://docs.agentstack.sh/templates).

## Building Agent Functionality

Expand Down Expand Up @@ -101,26 +115,29 @@ Runs the agent project in development mode.<br>

- **No Lock-In:** You can customize your setup at any time. AgentStack is designed to make it easy to get the components you need running right off the bat; it's up to you what to do next.

- **Provider Agnosticism:** AgentStack is designed to be provider agnostic in all ways. This means especially that the framework layer of your agent stack should be interoperable with every other layer. Frameworks must still be supported by AgentStack. See supported frameworks above.

AgentStack is not designed to be a low-code solution to building agents. Instead it is a great head-start for starting an agent project from scratch.

## Roadmap

### Framework Agnosticism

Development of AgentStack is being done primarily on [CrewAI](https://crewai.com). We will soon be working to make AgentStack fully framework-agnostic, meaning that any supported multi-agent framework can be used for your project.

### Tools
- Core Tools built by AgentStack
- More [core tools](https://docs.agentstack.sh/tools/core) built by AgentStack
- Preferred partners in the package directly
- Community partner tools added through external repositories

### New Stack Layers
- Prompting layer (DSPy)
- Eval Layer
- UI layer

### Other Features
- Generated testing
- Integrated benchmarking
- Easy integration of tools for browsing, RAG, and more.
- A fast interactive test runner with built-in support for coverage reporting.
- A live development server that warns about common mistakes.
- A build script to bundle your project for production.
- A live development server that warns about common mistakes (in progress).
- A build script to bundle your project for production (in progress).

## License

Expand Down
4 changes: 2 additions & 2 deletions docs/essentials/agentops.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: 'Using AgentOps makes the agent development process manageable'
AgentOps provides monitoring for agents in development and production.
It provides a dashboard for tracking agent performance, session replays, and custom reporting.

Additionally, AgentOps provides session drilldowns for viewing Crew agent interactions, LLM calls, and tool usage in real-time.
Additionally, AgentOps provides session drilldowns for viewing agent interactions, LLM calls, and tool usage in real-time.
This feature is useful for debugging and understanding how agents interact with users as well as other agents.

![Overview](https://github.com/AgentOps-AI/agentops/raw/main/docs/images/external/app_screenshots/session-replay.png)
Expand Down Expand Up @@ -44,6 +44,6 @@ AgentOps is baked into AgentStack projects by default! You only need to add an A

## Further Information

To get started, create an [AgentOps account](https://agentops.ai/?=crew).
To get started, create an [AgentOps account](https://agentops.ai/?=agentstack).

For feature requests or bug reports, please reach out to the AgentOps team on the [AgentOps Repo](https://github.com/AgentOps-AI/agentops).
10 changes: 6 additions & 4 deletions docs/essentials/generating-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,13 @@ To generate a new agent for your project, run:
agentstack generate agent <agent_name>
```

This command will modify two files, `crew.py` and `agents.yaml`.
This command will modify two files, your agent file (`crew.py` / `graph.py`) and `agents.yaml`.

## crew.py
## your agent file

This is the file that declares each of your agents and tasks. It's the core of your AgentStack project with Crew.
This is the file that declares each of your agents and tasks. It's the core of your AgentStack project and how AgentStack configures your framework.
- Crew projects have `crew.py`
- LangGraph projects have `graph.py`


## agents.yaml
Expand All @@ -26,6 +28,6 @@ Each agent has three prompt params:
- Backstory

And one configuration param:
- LLM - This value tells crew which model to use for this specific agent. It must be in `<provider>/<model>` format
- LLM - This value tells AgentStack which model to use for this specific agent. It must be in `<provider>/<model>` format

Ex: `openai/gpt-4o`
9 changes: 5 additions & 4 deletions docs/essentials/generating-tasks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,13 @@ To generate a new task for your project, run:
agentstack generate task <task_name>
```

This command will modify two files, `crew.py` and `agents.yaml`.
This command will modify two files, your agent file (`crew.py`/`graph.py`) and `agents.yaml`.

## crew.py

This is the file that declares each of your agents and tasks. It's the core of your AgentStack project with Crew.
## your agent file

This is the file that declares each of your agents and tasks. It's the core of your AgentStack project and how AgentStack configures your framework.
- Crew projects have `crew.py`
- LangGraph projects have `graph.py`

## agents.yaml

Expand Down
4 changes: 1 addition & 3 deletions docs/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,7 @@ agentstack init --template=<template_name/url>

## Building your project

AgentStack 0.2 is built on top of [CrewAI](https://docs.crewai.com/introduction). The majority of your development experience will be with Crew.

When working with your Crew project, AgentStack makes generating new agents and tasks easy.
AgentStack 0.3 and beyond is framework-agnostic! Choose any supported framework and start building. We help you scaffold your project quickly, but building complex routing and workflows is still done at the framework level. Be sure to understand how to build with your framework and turn to their documentation for guidance.

### Agents

Expand Down
Loading