agentstack


Nameagentstack JSON
Version 0.2.2.2 PyPI version JSON
download
home_pageNone
SummaryThe fastest way to build robust AI agents
upload_time2024-12-13 03:04:56
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # AgentStack [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/release/python-3100/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<img alt="Logo" align="right" src="https://raw.githubusercontent.com/bboynton97/agentstack-docs/3491fe490ea535e7def74c83182dfa8dcfb1f562/logo/dark-sm.svg" width="20%" />

Create AI agent projects from the command line.

- [Quickstart Guide](https://docs.agentstack.sh/quickstart) – How to create a new agent project.
- [Video Tutorial](https://www.loom.com/share/68d796b13cd94647bd1d7fae12b2358e?sid=7fdf595b-de84-4d51-9a81-ef1e9c8ac71c) – Follow along and build a web scrape agent with AgentStack

AgentStack works on macOS, Windows, and Linux.<br>
If something doesn't work, please [file an issue](https://github.com/agentops-ai/agentstack/issues/new).<br>
If you have questions or need help, please ask in our [Discord community](https://discord.gg/JdWkh9tgTQ).

> 🛠️🏃🏼‍♀️ The quickest way to build your powerful agent project

AgentStack serves as a great tool for starting your agent project and offers many CLI utilities for easy code-gen throughout the development process.

AgentStack is _not_ a low-code alternative to development. Developers will still need an understanding of how to build with their selected agent framework.

## Quick Overview

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


<p align='center'>
<img src='https://raw.githubusercontent.com/agentops-ai/agentstack/main/stack.png' width='600' alt='agentstack init'>
</p>

### Get Started Immediately

You **don't** need to install or configure tools like LangChain or LlamaIndex.<br>
They are preconfigured and hidden so that you can focus on the code.

Create a project, and you're good to go.

## Creating an Agent Project

**You'll need to have Python 3.10+ on your local development machine**. We recommend using the latest version. You can use [pyenv](https://github.com/pyenv/pyenv) to switch Python versions between different projects.

To create a new agent project, run:

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

It will create a directory with your project name inside the current folder.<br>
Inside that directory, it will generate the initial project structure and install the transitive dependencies.

No configuration or complicated folder structures, only the files you need to build your agent project.<br>
Once the initialization is done, you can open your project folder:

```sh
cd <your_agent_project>
```

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

## Building Agent Functionality

After generating a project, the next step is to build your agent project by creating Agents and Tasks. You can do this quickly with AgentStack:

```bash
agentstack generate agent/task <name>
```

Modify the agents and tasks by changing the `agents.yaml` and `tasks.yaml` configuration files in `src/config`

## Tooling

One of AgentStack's core principles is to establish the de facto agent _stack_. A critical component of this stack is the tooling and functionality given to agents beyond simply LLM capabilities.

AgentStack has worked to make access to tools as easy as possible, staying framework agnostic and featuring the best tools.

A list of all tools can be found [on our docs](https://docs.agentstack.sh/tools/core).

Adding tools is as simple as

```bash
agentstack tools add <tool_name>
```

## Running Your Agent

`agentstack run`

Runs the agent project in development mode.<br>

> 👀 Support for easy production deployment of agents is coming soon.

## Philosophy

- **Agents should be easy:** There are so many frameworks out there, but starting from scratch is a pain. Similar to `create-react-app`, AgentStack aims to simplify the "from scratch" process by giving you a simple boilerplate of an agent. It uses popular agent frameworks and LLM providers, but provides a cohesive curated experience on top of them.

- **No Configuration Required:** You don't need to configure anything. A reasonably good configuration of both development and production builds is handled for you so you can focus on writing code.

- **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.

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
- Preferred partners in the package directly
- Community partner tools added through external repositories

### 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.

## License

AgentStack is open source software [licensed as MIT](LICENSE).

## How to Contribute

AgentStack is a new project built by passionate AI agent developers! We'd love help making this tool better. Easy first issues are available, create new issues with feature ideas, or chat with us on our [Discord](https://discord.gg/JdWkh9tgTQ).

If you are an Agent Tool developer, feel free to create an issue or even a PR to add your tool to AgentStack. 

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "agentstack",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Braelyn Boynton <bboynton97@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/38/12/4708aeb6aa83f6bffffa4640d26056825ca1beec88c7ec0c097ecc02166e/agentstack-0.2.2.2.tar.gz",
    "platform": null,
    "description": "# AgentStack [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/release/python-3100/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n<img alt=\"Logo\" align=\"right\" src=\"https://raw.githubusercontent.com/bboynton97/agentstack-docs/3491fe490ea535e7def74c83182dfa8dcfb1f562/logo/dark-sm.svg\" width=\"20%\" />\n\nCreate AI agent projects from the command line.\n\n- [Quickstart Guide](https://docs.agentstack.sh/quickstart) \u2013 How to create a new agent project.\n- [Video Tutorial](https://www.loom.com/share/68d796b13cd94647bd1d7fae12b2358e?sid=7fdf595b-de84-4d51-9a81-ef1e9c8ac71c) \u2013 Follow along and build a web scrape agent with AgentStack\n\nAgentStack works on macOS, Windows, and Linux.<br>\nIf something doesn't work, please [file an issue](https://github.com/agentops-ai/agentstack/issues/new).<br>\nIf you have questions or need help, please ask in our [Discord community](https://discord.gg/JdWkh9tgTQ).\n\n> \ud83d\udee0\ufe0f\ud83c\udfc3\ud83c\udffc\u200d\u2640\ufe0f The quickest way to build your powerful agent project\n\nAgentStack serves as a great tool for starting your agent project and offers many CLI utilities for easy code-gen throughout the development process.\n\nAgentStack is _not_ a low-code alternative to development. Developers will still need an understanding of how to build with their selected agent framework.\n\n## Quick Overview\n\n```sh\npip install agentstack\nagentstack init <project_name>\n```\n\n\n<p align='center'>\n<img src='https://raw.githubusercontent.com/agentops-ai/agentstack/main/stack.png' width='600' alt='agentstack init'>\n</p>\n\n### Get Started Immediately\n\nYou **don't** need to install or configure tools like LangChain or LlamaIndex.<br>\nThey are preconfigured and hidden so that you can focus on the code.\n\nCreate a project, and you're good to go.\n\n## Creating an Agent Project\n\n**You'll need to have Python 3.10+ on your local development machine**. We recommend using the latest version. You can use [pyenv](https://github.com/pyenv/pyenv) to switch Python versions between different projects.\n\nTo create a new agent project, run:\n\n```sh\npip install agentstack\nagentstack init <project_name>\n```\n\nIt will create a directory with your project name inside the current folder.<br>\nInside that directory, it will generate the initial project structure and install the transitive dependencies.\n\nNo configuration or complicated folder structures, only the files you need to build your agent project.<br>\nOnce the initialization is done, you can open your project folder:\n\n```sh\ncd <your_agent_project>\n```\n\n### Templates\nAdditionally, pre-built templates are available as a shortcut to building your project. [View the available templates]().\n\n## Building Agent Functionality\n\nAfter generating a project, the next step is to build your agent project by creating Agents and Tasks. You can do this quickly with AgentStack:\n\n```bash\nagentstack generate agent/task <name>\n```\n\nModify the agents and tasks by changing the `agents.yaml` and `tasks.yaml` configuration files in `src/config`\n\n## Tooling\n\nOne of AgentStack's core principles is to establish the de facto agent _stack_. A critical component of this stack is the tooling and functionality given to agents beyond simply LLM capabilities.\n\nAgentStack has worked to make access to tools as easy as possible, staying framework agnostic and featuring the best tools.\n\nA list of all tools can be found [on our docs](https://docs.agentstack.sh/tools/core).\n\nAdding tools is as simple as\n\n```bash\nagentstack tools add <tool_name>\n```\n\n## Running Your Agent\n\n`agentstack run`\n\nRuns the agent project in development mode.<br>\n\n> \ud83d\udc40 Support for easy production deployment of agents is coming soon.\n\n## Philosophy\n\n- **Agents should be easy:** There are so many frameworks out there, but starting from scratch is a pain. Similar to `create-react-app`, AgentStack aims to simplify the \"from scratch\" process by giving you a simple boilerplate of an agent. It uses popular agent frameworks and LLM providers, but provides a cohesive curated experience on top of them.\n\n- **No Configuration Required:** You don't need to configure anything. A reasonably good configuration of both development and production builds is handled for you so you can focus on writing code.\n\n- **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.\n\nAgentStack 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.\n\n## Roadmap\n\n### Framework Agnosticism\n\nDevelopment 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. \n\n### Tools\n- Core Tools built by AgentStack\n- Preferred partners in the package directly\n- Community partner tools added through external repositories\n\n### Other Features\n- Generated testing\n- Integrated benchmarking\n- Easy integration of tools for browsing, RAG, and more.\n- A fast interactive test runner with built-in support for coverage reporting.\n- A live development server that warns about common mistakes.\n- A build script to bundle your project for production.\n\n## License\n\nAgentStack is open source software [licensed as MIT](LICENSE).\n\n## How to Contribute\n\nAgentStack is a new project built by passionate AI agent developers! We'd love help making this tool better. Easy first issues are available, create new issues with feature ideas, or chat with us on our [Discord](https://discord.gg/JdWkh9tgTQ).\n\nIf you are an Agent Tool developer, feel free to create an issue or even a PR to add your tool to AgentStack. \n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "The fastest way to build robust AI agents",
    "version": "0.2.2.2",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cbeb8b2582fddd7bccbd84a622c92f2dce1d35d17044f6361aaaaa82d932dab1",
                "md5": "7cd59e61453668bf4b278961c03fc447",
                "sha256": "479bba50d085091b55ac2dee744bc90f59506f39d668ac6ddd92bc2751575f5b"
            },
            "downloads": -1,
            "filename": "agentstack-0.2.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7cd59e61453668bf4b278961c03fc447",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 99467,
            "upload_time": "2024-12-13T03:04:54",
            "upload_time_iso_8601": "2024-12-13T03:04:54.062604Z",
            "url": "https://files.pythonhosted.org/packages/cb/eb/8b2582fddd7bccbd84a622c92f2dce1d35d17044f6361aaaaa82d932dab1/agentstack-0.2.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "38124708aeb6aa83f6bffffa4640d26056825ca1beec88c7ec0c097ecc02166e",
                "md5": "496bc22cf05651f80d9251642046ead4",
                "sha256": "8d12bac86675921d70042ffb936639ad39c1238ba4c72c3bb9590f5f246135bb"
            },
            "downloads": -1,
            "filename": "agentstack-0.2.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "496bc22cf05651f80d9251642046ead4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 87303,
            "upload_time": "2024-12-13T03:04:56",
            "upload_time_iso_8601": "2024-12-13T03:04:56.685265Z",
            "url": "https://files.pythonhosted.org/packages/38/12/4708aeb6aa83f6bffffa4640d26056825ca1beec88c7ec0c097ecc02166e/agentstack-0.2.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-13 03:04:56",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "agentstack"
}
        
Elapsed time: 0.40671s