[pull] main from AgentOps-AI:main

.github/workflows/codecov.yml

@@ -31,10 +31,10 @@ jobs:
         pip install tox
 
     - name: Run tests with tox
-      run: tox
+      run: tox -m quick  # quick runs all 3.12 tests and then combines coverage
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v2
+      uses: codecov/codecov-action@v5
       with:
         token: ${{ secrets.CODECOV_TOKEN }}
         files: ./coverage.xml

.github/workflows/compile-llms-txt.yml

@@ -0,0 +1,34 @@
+name: Compile llms.txt
+
+on:
+  pull_request:
+    types:
+      - closed
+    branches:
+      - main
+    paths:
+      - 'docs/**/*.mdx'
+      - 'docs/compile_llms_txt.py'
+
+jobs:
+  compile:
+    # Only run if the PR was merged (not just closed)
+    if: github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - name: Compile llms.txt
+        run: |
+          cd docs
+          python compile_llms_txt.py
+      - name: Commit and push changes
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Action"
+          git add docs/llms.txt
+          git commit -m "Update llms.txt" || exit 0
+          git push

.github/workflows/deploy.yml

@@ -18,11 +18,43 @@ jobs:
           python-version: '3.9'
 
       - name: Install dependencies
-        run: pip install build twine
+        run: pip install build twine toml
 
       - name: Build the package
         run: python -m build
 
+      - name: Check version matches
+        run: |
+          import toml
+          import os
+          import sys
+
+          # Read pyproject.toml
+          with open('pyproject.toml', 'r') as f:
+              pyproject = toml.load(f)
+
+          # Get version from pyproject.toml
+          project_version = pyproject['project']['version']
+
+          # Get release tag (strip 'v' prefix if present)
+          github_ref = os.environ['GITHUB_REF']
+          tag_version = github_ref.split('/')[-1]
+          if tag_version.startswith('v'):
+              tag_version = tag_version[1:]
+
+          print(f"pyproject.toml version: {project_version}")
+          print(f"Release tag version: {tag_version}")
+
+          # Compare versions
+          if project_version != tag_version:
+              print("Version mismatch!")
+              print(f"pyproject.toml version ({project_version}) does not match")
+              print(f"release tag version ({tag_version})")
+              sys.exit(1)
+
+          print("Versions match!")
+        shell: python
+
       - name: Upload to PyPI
         env:
           TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}

.github/workflows/python-testing.yml

@@ -25,15 +25,17 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.10,3.11,3.12]
+        python-version: ["3.10","3.11","3.12"]  # versions need to be strings
 
     steps:
       - uses: actions/checkout@v2
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11' # Use a default Python version for running tox
+          python-version: ${{ matrix.python-version }}
       - name: Install tox
         run: pip install tox
+      - name: Install tox-gh-actions
+        run: pip install tox-gh-actions  # allows tox to get the current python version
       - name: Run tests with tox
-        run: tox
+        run: tox  # we can't pass arguments to tox when using tox-gh-actions, so all frameworks happen in one run

.github/workflows/release-checksum.yml

@@ -0,0 +1,24 @@
+name: Create checksum.txt for releases
+
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run checksum action
+        uses: thewh1teagle/checksum@v1
+        with:
+          patterns: |
+            *.zip
+            *.tar.gz
+          algorithm: sha256
+        env:
+          # You must enable write permission in github.com/user/repo/settings/actions -> Workflow permissions -> Read and write permissions
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -175,9 +175,13 @@ ex/
 **/ex/
 cookiecutter.json
 
+tests/tmp
+
 examples/tests/
 examples/tests/**/*
 
 uv.lock
 .DS_Store
 
+.python-version
+

MANIFEST.in

@@ -1,3 +1,4 @@
 recursive-include agentstack/templates *
-recursive-include agentstack/tools *
+recursive-include agentstack/frameworks/templates *
+recursive-include agentstack/_tools *
 include agentstack.json .env .env.example

README.md

@@ -1,6 +1,23 @@
-# 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) ![python-testing](https://github.com/agentops-ai/agentstack/actions/workflows/python-testing.yml/badge.svg) ![mypy](https://github.com/agentops-ai/agentstack/actions/workflows/mypy.yml/badge.svg) [![codecov.io](https://codecov.io/github/agentops-ai/agentstack/coverage.svg?branch=master)](https://codecov.io/github/agentops-ai/agentstack>?branch=master)
+# AgentStack
 
-<img alt="Logo" align="right" src="https://raw.githubusercontent.com/bboynton97/agentstack-docs/3491fe490ea535e7def74c83182dfa8dcfb1f562/logo/dark-sm.svg" width="20%" />
+ [![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) ![python-testing](https://github.com/agentops-ai/agentstack/actions/workflows/python-testing.yml/badge.svg) ![mypy](https://github.com/agentops-ai/agentstack/actions/workflows/mypy.yml/badge.svg) [![codecov.io](https://codecov.io/github/agentops-ai/agentstack/coverage.svg?branch=master)](https://codecov.io/github/agentops-ai/agentstack>?branch=master)
+
+
+AgentStack scaffolds your _agent stack_ - The tech stack that collectively is your agent
+
+<p align='center'>
+<img src='./docs/images/the_agent_stack.png' width='600' alt='AgentStack items'>
+</p>
+
+### Install AgentStack
+
+```sh
+curl --proto '=https' --tlsv1.2 -LsSf https://install.agentstack.sh | sh
+```
+
+or python [other install methods](https://docs.agentstack.sh/installation)
+
+### Start your agent!
 
 Create AI agent projects from the command line.
 
@@ -17,18 +34,12 @@ AgentStack serves as a great tool for starting your agent project and offers man
 
 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>
-```
-
-AgentStack scaffolds your _agent stack_ - the tech stack that collectively is your agent
-
-<p align='center'>
-<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, LangGraph, OpenAI Swarms and LlamaStack
+  - 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
 
@@ -44,7 +55,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 # or other install method
 agentstack init <project_name>
 ```
 
@@ -56,10 +67,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
 
@@ -101,33 +119,36 @@ 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
 
 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).
+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). Make sure you read our contributor documentation to familiarize yourself with the project at [How to Contribute](https://docs.agentstack.sh/contributing/how-to-contribute).
 
-If you are an Agent Tool developer, feel free to create an issue or even a PR to add your tool to AgentStack. 
+If you are an Agent Tool developer, feel free to create an issue or even a PR to add your tool to AgentStack. 

TODO.md

@@ -0,0 +1,35 @@
+## Wizard
+
+
+## LangGraph
+
+[ ] Bug: empty `bind_tools` list on a new Agent throws an error
+
+[ ] Reliably handle adding two Tasks and two Agent via CLI
+
+[ ] Create a new template demonstrating graph usage
+
+
+"Top of Funnel"
+
+[√] Hello World!
+
+[√] Catch common exception types from the user's first `agentstack run` and provide a helpful error message.
+    - In order to avoid importing all the sub-libraries, use string matching to determine what the exception is. 
+
+[√] Allow the user to select from a list of tools if a <tool_name> is not provided to `agenstack add tools`
+
+[ ] Handle all setup tasks that `agentstack init` needs. 
+    - Wrap the output in a `curses` window to show progress.
+    - Prevent the user from having to scroll back up to find the help text from the `init` command.
+    - Use `uv` for all package management. 
+
+[√] Modify agentops init to indicate which tools are being used.
+    - Possibly with an `agentstack.get_tags()` method that automatically sets relevant tags.
+
+[√] If there is only one agent in the project, treat it as a default. 
+    - New tasks should be assigned to it. 
+
+[√] Wrap tools in the framework's protocol before including them in the project.
+    - Access tools with `agentstack.tools['tool_name']` which dynamically generates the wrapped tool. 
+    - This will be a breaking change with the 0.3 release.