Adds an example of a good "general case" SQL tool: * enforces read-only mode * hints to the LLM to discover the tables and schemas for the tables it needs before any query * uses RetryableToolErrors to hint to the LLM about what to do next Docs: https://github.com/ArcadeAI/docs/pull/345 For testing, `TEST_POSTGRES_DATABASE_CONNECTION_STRING` has been set in the repo (from Neon). details in 1 password. <img width="1178" height="1091" alt="464977013-49aff5e5-e301-4ca0-83b5-3ea742db2283" src="https://github.com/user-attachments/assets/9344c27b-015d-4b91-907e-84f2e4193e16" /> |
||
|---|---|---|
| .github | ||
| .vscode | ||
| contrib | ||
| docker | ||
| examples | ||
| libs | ||
| porter | ||
| schemas/preview | ||
| toolkits | ||
| .editorconfig | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .prettierignore | ||
| .prettierrc.toml | ||
| .ruff.toml | ||
| CONTRIBUTING.md | ||
| cspell.config.yaml | ||
| LICENSE | ||
| Makefile | ||
| pyproject.toml | ||
| README.md | ||
| worker.toml | ||
Documentation • Tools • Quickstart • Contact Us
Arcade AI Platform
Arcade is a developer platform that lets you build, deploy, and manage tools for AI agents.
This repository contains the core Arcade libraries, organized as separate packages for maximum flexibility and modularity:
- arcade-core - Core platform functionality and schemas | Source code |
pip install arcade-core| - arcade-tdk - Tool Development Kit with the
@tooldecorator | Source code |pip install arcade-tdk| - arcade-serve - Serving infrastructure for workers and MCP servers | Source code |
pip install arcade-serve| - arcade-evals - Evaluation framework for testing tool performance | Source code |
pip install 'arcade-ai[evals]| - arcade-cli - Command-line interface for the Arcade platform | Source code |
pip install arcade-ai|
To learn more about Arcade.dev, check out our documentation.
Pst. hey, you, give us a star if you like it!
Quick Start
Installation
For development, install all packages with dependencies using uv workspace:
# Install all packages and dev dependencies
uv sync --extra all --dev
# Or use the Makefile (includes pre-commit hooks)
make install
For production use, install individual packages as needed:
pip install arcade-ai # CLI
pip install 'arcade-ai[evals]' # CLI + Evaluation framework
pip install 'arcade-ai[all]' # CLI + Serving infra + eval framework + TDK
pip install arcade_serve # Serving infrastructure
pip install arcade-tdk # Tool Development Kit
Development
Use the Makefile for standard tasks:
# Run tests
make test
# Run linting and type checking
make check
# Build all packages
make build
# See all available commands
make help
Client Libraries
-
ArcadeAI/arcade-py: The Python client for interacting with Arcade.
-
ArcadeAI/arcade-js: The JavaScript client for interacting with Arcade.
-
ArcadeAI/arcade-go: The Go client for interacting with Arcade.
Support and Community
- Discord: Join our Discord community for real-time support and discussions.
- GitHub: Contribute or report issues on the Arcade GitHub repository.
- Documentation: Find in-depth guides and API references at Arcade Documentation.