langgraph-agent-toolkit 0.4.0__tar.gz → 0.4.2__tar.gz

{langgraph_agent_toolkit-0.4.0 → langgraph_agent_toolkit-0.4.2}/.github/workflows/release.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
         with:
-          version: "0.6.12"
+          version: "0.7.2"
           enable-cache: true
 
       - name: Set up Python

langgraph_agent_toolkit-0.4.2/.github/workflows/sphinx.yml

@@ -0,0 +1,138 @@
+name: Build and Deploy Sphinx Docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - ".github/workflows/sphinx.yml"
+      - "langgraph_agent_toolkit/**"
+      - "pyproject.toml"
+  workflow_dispatch: # Allow manual triggering
+
+# Add permissions to allow GitHub Actions to push to gh-pages
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Fetch all history for proper versioning
+
+      - name: Create pip cache directory
+        run: mkdir -p /home/runner/.cache/pip
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          # Only enable caching if the directory exists
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.7.2"
+
+      - name: Install dependencies with uv
+        run: |
+          # Install the package itself with all dependencies (instead of just installing the dev dependencies)
+          uv pip install -e ".[all-llms,all-backends,all-observability]"
+          uv pip install sphinx-rtd-theme sphinx-pyproject rootutils mock
+        env:
+          UV_SYSTEM_PYTHON: 1
+
+      - name: Create static directory if it doesn't exist
+        run: |
+          mkdir -p docs/_static
+
+      - name: Generate API docs
+        run: |
+          # Enhanced API documentation generation with better code documentation
+          sphinx-apidoc -f -e -o docs/generated langgraph_agent_toolkit \
+            --separate \
+            --no-toc \
+            --no-headings \
+            --module-first \
+            --doc-project="API Reference"
+        env:
+          # Environment variables to enable fake model and bypass authentication
+          USE_FAKE_MODEL: "true"
+          OPENAI_API_KEY: "sk-fake-key-for-docs-generation"
+          OPENAI_MODEL_NAME: "gpt-4-fake-model"
+          OPENAI_API_BASE_URL: "https://fake-api.openai.com/v1"
+          OPENAI_API_VERSION: "2023-05-15"
+          LANGFUSE_SECRET_KEY: "lf-sk-fake-for-docs"
+          LANGFUSE_PUBLIC_KEY: "lf-pk-fake-for-docs"
+          LANGFUSE_HOST: "http://localhost:3000"
+          MEMORY_BACKEND: "sqlite"
+          SQLITE_DB_PATH: ":memory:"
+          ANTHROPIC_API_KEY: "sk-ant-fake-key"
+          ANTHROPIC_MODEL_NAME: "claude-3-fake"
+          GOOGLE_VERTEXAI_API_KEY: "fake-vertexai-key"
+          GOOGLE_VERTEXAI_MODEL_NAME: "gemini-fake"
+          GOOGLE_GENAI_API_KEY: "fake-genai-key"
+          GOOGLE_GENAI_MODEL_NAME: "gemini-pro-fake"
+          OBSERVABILITY_BACKEND: "empty"
+
+      - name: Create autosummary template files
+        run: |
+          mkdir -p docs/_templates/autosummary
+          echo '{{ fullname | escape | underline }}
+
+          .. automodule:: {{ fullname }}
+             :members:
+             :undoc-members:
+             :show-inheritance:
+             :special-members: __init__' > docs/_templates/autosummary/module.rst
+
+          echo '{{ fullname | escape | underline }}
+
+          .. currentmodule:: {{ module }}
+
+          .. autoclass:: {{ objname }}
+             :members:
+             :show-inheritance:
+             :inherited-members:
+             :special-members: __init__
+             :undoc-members:' > docs/_templates/autosummary/class.rst
+
+      - name: Build documentation
+        run: |
+          cd docs && sphinx-build -b html -a -E -v . _build/html
+          # The -v flag provides verbose output to see any import errors
+        env:
+          # Environment variables to enable fake model and bypass authentication
+          USE_FAKE_MODEL: "true"
+          OPENAI_API_KEY: "sk-fake-key-for-docs-generation"
+          OPENAI_MODEL_NAME: "gpt-4-fake-model"
+          OPENAI_API_BASE_URL: "https://fake-api.openai.com/v1"
+          OPENAI_API_VERSION: "2023-05-15"
+          LANGFUSE_SECRET_KEY: "lf-sk-fake-for-docs"
+          LANGFUSE_PUBLIC_KEY: "lf-pk-fake-for-docs"
+          LANGFUSE_HOST: "http://localhost:3000"
+          MEMORY_BACKEND: "sqlite"
+          SQLITE_DB_PATH: ":memory:"
+          ANTHROPIC_API_KEY: "sk-ant-fake-key"
+          ANTHROPIC_MODEL_NAME: "claude-3-fake"
+          GOOGLE_VERTEXAI_API_KEY: "fake-vertexai-key"
+          GOOGLE_VERTEXAI_MODEL_NAME: "gemini-fake"
+          GOOGLE_GENAI_API_KEY: "fake-genai-key"
+          GOOGLE_GENAI_MODEL_NAME: "gemini-pro-fake"
+          # Disable all observability
+          OBSERVABILITY_BACKEND: "none"
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/_build/html
+          force_orphan: true # Create a single-branch gh-pages
+          full_commit_message: "Docs: Update documentation site"
+          enable_jekyll: false

{langgraph_agent_toolkit-0.4.0 → langgraph_agent_toolkit-0.4.2}/.github/workflows/test.yml

@@ -29,6 +29,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
+
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
@@ -36,7 +37,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
         with:
-          version: "0.6.12"
+          version: "0.7.2"
       - name: Install dependencies with uv
         run: |
           uv sync --all-extras --frozen
@@ -137,7 +138,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
         with:
-          version: "0.6.12"
+          version: "0.7.2"
       - name: Install ONLY CLIENT dependencies with uv
         run: |
           uv sync --frozen --only-group client --only-group dev

{langgraph_agent_toolkit-0.4.0 → langgraph_agent_toolkit-0.4.2}/.gitignore

@@ -81,6 +81,7 @@ instance/
 docs/_build/
 docs/build/
 docs/source/generated
+docs/generated/
 
 # PyBuilder
 .pybuilder/
@@ -177,6 +178,20 @@ cython_debug/
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea
 
+# documentation
+# Sphinx build directory
+docs/_build/
+
+# Sphinx cache and temporary files
+docs/.doctrees/
+docs/.buildinfo
+
+# reStructuredText temporary files
+docs/*.rst~
+
+# Sphinx-generated files
+docs/generated/
+
 # configs
 configs/**/*.yaml
 !configs/**/*.example.yaml

{langgraph_agent_toolkit-0.4.0 → langgraph_agent_toolkit-0.4.2}/CHANGELOG.md

@@ -6,6 +6,36 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.2]
+
+### Fixed
+
+- Streaming bug
+- Steamlit welcom message display
+- Client handling error
+- Package dependencies
+
+## [0.4.1]
+
+### Updated
+
+- Client API to fully align with server endpoints
+- Extended invoke, stream methods with additional parameters
+
+### Added
+
+- Message management methods in the client (add_messages, aadd_messages)
+- Chat history retrieval methods (get_history, aget_history)
+- History clearing methods (clear_history, aclear_history)
+- Synchronous feedback creation method (create_feedback)
+- Support for model_config_key parameter
+- Support for recursion_limit parameter
+
+### Fixed
+
+- Client tests to properly mock API endpoints
+- Parameter handling in stream and invoke methods
+
 ## [0.4.0]
 
 ### Updated

langgraph_agent_toolkit-0.4.2/PKG-INFO

@@ -0,0 +1,318 @@
+Metadata-Version: 2.4
+Name: langgraph-agent-toolkit
+Version: 0.4.2
+Summary: Full toolkit for running an AI agent service built with LangGraph, FastAPI and Streamlit
+Project-URL: documentation, https://kryvokhyzha.github.io/langgraph-agent-toolkit
+Project-URL: repository, https://github.com/kryvokhyzha/langgraph-agent-toolkit
+Project-URL: PyPI, https://pypi.org/project/langgraph-agent-toolkit
+Author-email: Roman Kryvokhyzha <kriwohizha@gmail.com>, Joshua Carroll <carroll.joshk@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,blueprint,fastapi,langgraph,litellm,streamlit
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.11
+Requires-Dist: duckduckgo-search>=7.3.0
+Requires-Dist: fastapi~=0.115.5
+Requires-Dist: fire~=0.7.0
+Requires-Dist: grpcio>=1.68.0
+Requires-Dist: httpx~=0.28.1
+Requires-Dist: jinja2~=3.1.6
+Requires-Dist: jiter~=0.9.0
+Requires-Dist: joblib~=1.4.2
+Requires-Dist: langchain-community~=0.3.21
+Requires-Dist: langchain-core~=0.3.52
+Requires-Dist: langgraph-checkpoint-postgres~=2.0.19
+Requires-Dist: langgraph-checkpoint-sqlite~=2.0.6
+Requires-Dist: langgraph-cli[inmem]~=0.2.3
+Requires-Dist: langgraph-supervisor~=0.0.16
+Requires-Dist: langgraph~=0.3.30
+Requires-Dist: loguru~=0.7.3
+Requires-Dist: multidict>6.3.2
+Requires-Dist: numpy~=1.26.4; python_version <= '3.12'
+Requires-Dist: numpy~=2.2.3; python_version >= '3.13'
+Requires-Dist: pandas~=2.2.3
+Requires-Dist: psycopg[binary,pool]~=3.2.4
+Requires-Dist: pyarrow>=19.0.1
+Requires-Dist: pydantic-settings~=2.9.1
+Requires-Dist: pydantic~=2.11.1
+Requires-Dist: pyowm~=3.3.0
+Requires-Dist: python-dotenv~=1.1.0
+Requires-Dist: rootutils>=1.0.7
+Requires-Dist: setuptools>=75.6.0
+Requires-Dist: streamlit~=1.44.1
+Requires-Dist: uvicorn~=0.34.0
+Requires-Dist: watchdog~=6.0.0
+Provides-Extra: all-backends
+Requires-Dist: azure-functions~=1.23.0; extra == 'all-backends'
+Requires-Dist: gunicorn~=23.0.0; extra == 'all-backends'
+Requires-Dist: mangum~=0.19.0; extra == 'all-backends'
+Requires-Dist: uvicorn~=0.34.2; extra == 'all-backends'
+Provides-Extra: all-llms
+Requires-Dist: langchain-anthropic~=0.3.12; extra == 'all-llms'
+Requires-Dist: langchain-aws~=0.2.22; extra == 'all-llms'
+Requires-Dist: langchain-deepseek~=0.1.3; extra == 'all-llms'
+Requires-Dist: langchain-google-genai~=2.1.4; extra == 'all-llms'
+Requires-Dist: langchain-google-vertexai~=2.0.21; extra == 'all-llms'
+Requires-Dist: langchain-groq~=0.3.2; extra == 'all-llms'
+Requires-Dist: langchain-ollama~=0.3.2; extra == 'all-llms'
+Requires-Dist: langchain-openai~=0.3.12; extra == 'all-llms'
+Provides-Extra: all-observability
+Requires-Dist: langfuse~=2.60.3; extra == 'all-observability'
+Requires-Dist: langsmith~=0.3.31; extra == 'all-observability'
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic~=0.3.12; extra == 'anthropic'
+Provides-Extra: aws
+Requires-Dist: langchain-aws~=0.2.22; extra == 'aws'
+Provides-Extra: aws-backend
+Requires-Dist: mangum~=0.19.0; extra == 'aws-backend'
+Provides-Extra: azure-backend
+Requires-Dist: azure-functions~=1.23.0; extra == 'azure-backend'
+Provides-Extra: deepseek
+Requires-Dist: langchain-deepseek~=0.1.3; extra == 'deepseek'
+Provides-Extra: google-genai
+Requires-Dist: langchain-google-genai~=2.1.4; extra == 'google-genai'
+Provides-Extra: google-vertexai
+Requires-Dist: langchain-google-vertexai~=2.0.21; extra == 'google-vertexai'
+Provides-Extra: groq
+Requires-Dist: langchain-groq~=0.3.2; extra == 'groq'
+Provides-Extra: gunicorn-backend
+Requires-Dist: gunicorn~=23.0.0; extra == 'gunicorn-backend'
+Requires-Dist: uvicorn[standard]~=0.34.2; extra == 'gunicorn-backend'
+Provides-Extra: langfuse
+Requires-Dist: langfuse~=2.60.3; extra == 'langfuse'
+Provides-Extra: langsmith
+Requires-Dist: langsmith~=0.3.31; extra == 'langsmith'
+Provides-Extra: ollama
+Requires-Dist: langchain-ollama~=0.3.2; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: langchain-openai~=0.3.12; extra == 'openai'
+Provides-Extra: uvicorn-backend
+Requires-Dist: uvicorn~=0.34.2; extra == 'uvicorn-backend'
+Description-Content-Type: text/markdown
+
+<div align="center">
+   <img alt="LangGraph Agent Toolkit Logo" src="https://github.com/kryvokhyzha/langgraph-agent-toolkit/blob/main/docs/media/logo.svg?raw=true" width="300">
+</div>
+
+---
+
+# 🧰 LangGraph Agent Toolkit
+
+|            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| CI/Testing | [![build status](https://github.com/kryvokhyzha/langgraph-agent-toolkit/actions/workflows/test.yml/badge.svg)](https://github.com/kryvokhyzha/langgraph-agent-toolkit/actions/workflows/test.yml) [![docs status](https://github.com/kryvokhyzha/langgraph-agent-toolkit/actions/workflows/sphinx.yml/badge.svg)](https://github.com/kryvokhyzha/langgraph-agent-toolkit/actions/workflows/sphinx.yml) [![codecov](https://codecov.io/gh/kryvokhyzha/langgraph-agent-toolkit/graph/badge.svg?token=OHSACTNSWZ)](https://codecov.io/gh/kryvokhyzha/langgraph-agent-toolkit) |
+| Package    | [![PyPI version](https://img.shields.io/pypi/v/langgraph-agent-toolkit.svg)](https://pypi.org/project/langgraph-agent-toolkit/) [![PyPI Downloads](https://img.shields.io/pypi/dm/langgraph-agent-toolkit.svg)](https://pypi.org/project/langgraph-agent-toolkit/) [![Python Version](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fkryvokhyzha%2Flanggraph-agent-toolkit%2Frefs%2Fheads%2Fmain%2Fpyproject.toml)](https://github.com/kryvokhyzha/langgraph-agent-toolkit/blob/main/pyproject.toml)           |
+| Meta       | [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff) [![GitHub License](https://img.shields.io/github/license/kryvokhyzha/langgraph-agent-toolkit)](https://github.com/kryvokhyzha/langgraph-agent-toolkit/blob/main/LICENSE)                                                                                                                                                                                                                                                                               |
+
+<!-- [![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_red.svg)](https://langgraph-agent-toolkit.streamlit.app/) -->
+
+## 📋 Introduction
+
+A comprehensive toolkit for building, deploying, and managing AI agents using
+LangGraph, FastAPI, and Streamlit. It provides a production-ready framework for
+creating conversational AI agents with features like multi-provider LLM support,
+streaming responses, observability, memory and prompt management.
+
+### What is langGraph-agent-toolkit?
+
+The langgraph-agent-toolkit is a full-featured framework for developing and
+deploying AI agent services. Built on the foundation of:
+
+- **[LangGraph](https://langchain-ai.github.io/langgraph/)** for agent creation
+  with advanced flows and human-in-the-loop capabilities
+- **[FastAPI](https://fastapi.tiangolo.com/)** for robust, high-performance API
+  services with streaming support
+- **[Streamlit](https://streamlit.io/)** for intuitive user interfaces
+
+Key components include:
+
+- Data structures and settings built with
+  **[Pydantic](https://github.com/pydantic/pydantic)**
+- **[LiteLLM](https://github.com/BerriAI/litellm)** proxy for universal
+  multi-provider LLM support
+- Comprehensive memory management and persistence using PostgreSQL/SQLite
+- Advanced observability tooling via Langfuse and Langsmith
+- Modular architecture allowing customization while maintaining a consistent
+  application structure
+
+Whether you're building a simple chatbot or complex multi-agent system, this
+toolkit provides the infrastructure to develop, test, and deploy your
+LangGraph-based agents with confidence.
+
+## 📑 Contents
+
+- [Introduction](#-introduction)
+- [Quickstart](#-quickstart)
+- [Installation Options](#-installation-options)
+- [Architecture](#architecture)
+- [Key Features](#-key-features)
+- [Environment Setup](#environment-setup)
+- [Project Structure](#-project-structure)
+- [Setup and Usage](#setup-and-usage)
+- [Documentation](#-documentation)
+- [Useful Resources](#-useful-resources)
+- [Development and Contributing](#-development-and-contributing)
+- [License](#-license)
+
+## 🚀 Quickstart
+
+1. Create a `.env` file based on [`.env.example`](./.env.example)
+
+2. **Option 1: Run with Python from source**
+
+   ```sh
+   # Install dependencies
+   pip install uv
+   uv sync --frozen
+   source .venv/bin/activate
+
+   # Start the service
+   python langgraph_agent_toolkit/run_service.py
+
+   # In another terminal
+   source .venv/bin/activate
+   streamlit run langgraph_agent_toolkit/streamlit_app.py
+   ```
+
+3. **Option 2: Run with Python from PyPi repository**
+
+   ```sh
+   pip install langgraph-agent-toolkit
+   ```
+
+   ℹ️ For more details on installation options, see the
+   [Installation Documentation](docs/installation.rst).
+
+4. **Option 3: Run with Docker**
+
+   ```sh
+   docker compose watch
+   ```
+
+<a name="installation-options"></a>
+
+## 📦 Installation Options
+
+The toolkit supports multiple installation options using "extras" to include
+just the dependencies you need.
+
+For detailed installation instructions and available extras, see the
+[Installation Documentation](docs/installation.rst).
+
+<a name="architecture"></a>
+
+## 🏗️ Architecture
+
+<img src="https://github.com/kryvokhyzha/langgraph-agent-toolkit/blob/main/docs/media/agent_architecture.png?raw=true" width="800">
+
+<a name="key-features"></a>
+
+## ✨ Key Features
+
+1. **LangGraph Integration**
+
+   - Latest LangGraph v0.3 features
+   - Human-in-the-loop with `interrupt()`
+   - Flow control with `Command` and `langgraph-supervisor`
+
+2. **API Service**
+
+   - FastAPI with streaming and non-streaming endpoints
+   - Support for both token-based and message-based streaming
+   - Multiple agent support with URL path routing
+   - Available agents and models listed at `/info` endpoint
+   - Supports different runners (unicorn, gunicorn, mangum, azure functions)
+
+3. **Developer Experience**
+
+   - Asynchronous design with async/await
+   - Docker configuration with live reloading
+   - Comprehensive testing suite
+
+4. **Enterprise Components**
+   - Configurable PostgreSQL/SQLite connection pools
+   - Observability via Langfuse and Langsmith
+   - User feedback system
+   - Prompt management system
+   - LiteLLM proxy integration
+
+For more details on features, see the [Usage Documentation](docs/usage.rst).
+
+<a name="environment-setup"></a>
+
+## ⚙️ Environment Setup
+
+For detailed environment setup instructions, including creating your `.env` file
+and configuring LiteLLM, see the
+[Environment Setup Documentation](docs/environment_setup.rst).
+
+<a name="project-structure"></a>
+
+## 📂 Project Structure
+
+The repository contains:
+
+- `langgraph_agent_toolkit/agents/blueprints/`: Agent definitions
+- `langgraph_agent_toolkit/agents/agent_executor.py`: Agent execution control
+- `langgraph_agent_toolkit/schema/`: Protocol schema definitions
+- `langgraph_agent_toolkit/core/`: Core modules (LLM, memory, settings)
+- `langgraph_agent_toolkit/service/service.py`: FastAPI service
+- `langgraph_agent_toolkit/client/client.py`: Service client
+- `langgraph_agent_toolkit/streamlit_app.py`: Chat interface
+- `docker/`: Docker configurations
+- `tests/`: Test suite
+
+<a name="setup-and-usage"></a>
+
+## 🛠️ Setup and Usage
+
+For detailed setup and usage instructions, including building your own agent,
+Docker setup, using the AgentClient, and local development, see the
+[Usage Documentation](docs/usage.rst).
+
+<a name="documentation"></a>
+
+## 📚 Documentation
+
+Full documentation is available in the `docs/` directory and includes:
+
+- [Installation Guide](docs/installation.rst)
+- [Environment Setup](docs/environment_setup.rst)
+- [Usage Guide](docs/usage.rst)
+
+<a name="useful-resources"></a>
+
+## 📚 Useful Resources
+
+- [LangGraph documentation](https://langchain-ai.github.io/langgraph/concepts/low_level/#multiple-schemas)
+- [LangGraph Memory Concept](https://langchain-ai.github.io/langgraph/concepts/memory/)
+- [LangGraph Memory Persistence](https://langchain-ai.github.io/langgraph/concepts/persistence/#memory)
+- [How to edit graph state](https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/edit-graph-state/)
+- [How to create tools in Langchain](https://python.langchain.com/docs/how_to/custom_tools/)
+- [Simple Serverless FastAPI with AWS Lambda](https://www.deadbear.io/simple-serverless-fastapi-with-aws-lambda/)
+
+<a name="development-and-contributing"></a>
+
+## 👥 Development and Contributing
+
+Thank you for considering contributing to `Langgraph Agent Toolkit`! We
+encourage the community to post Issues and Pull Requests.
+
+Before you get started, please see our [Contribution Guide](CONTRIBUTING.md).
+
+<a name="license"></a>
+
+## 📄 License
+
+This project is licensed under the MIT License - see the LICENSE file for
+details.