agentup 0.6.5

Create AI agents with all the trappings, out of the box.

English | 简体中文

Bringing to AI Agents, what Docker brought to containers

 

🚀 Active Development 🏃‍♂️ We are moving fast, things will break!

Why AgentUp?

Just as Docker made applications immutable, reproducible, and ops-friendly, AgentUp does the same for AI agents. Define your agent with configuration, and it runs consistently anywhere. Share agents with teammates who can clone / fork and run them instantly. Deploy knowing your agent will behave identically across development, staging, and production environments.

AgentUp is built by engineers who've created open-source solutions powering mission-critical systems at Google, GitHub, Nvidia, Red Hat, Shopify and more. We understand what it takes to build stable, secure, scalable software - and we're applying those same principles to make AI agents truly production-ready, secure and reliable.

AgentUp: Developer-First Agent Framework

AgentUp delivers enterprise-grade agent infrastructure built for professional developers who demand both power and simplicity.

Developer-First Operations: Built by developers who understand real-world constraints. Each agent lives in its own repository with a single AgentUp configuration file. Clone, run agentup run, and all dependencies resolve during initialization - no more environment setup headaches.

Secure by Design: Fine-grained, scope-based access control with OAuth2, JWT, and API key authentication built-in, preventing unauthorized Tools / MCP access, ensuring data protection. Security isn't an afterthought - it's foundational architecture in AgentUp.

Configuration-Driven Architecture: Define complex agent behaviors, data sources, and workflows through declarative configuration. Skip weeks of boilerplate and framework wrestling. Your agents become portable, versionable assets with clear contracts defining their capabilities and interactions.

Extensible Ecosystem for customizations: Need RAG, image processing, custom API logic? No problem. Leverage community plugins or build custom extensions that automatically inherit AgentUp's middleware, security, and operational features. Independent plugin versioning integrates seamlessly with existing CI/CD pipelines, ensuring core platform updates don't break your implementations. With AgentUp you get the immediate feedback of a running agent, along with the extensibility of a framework.

Agent-to-Agent Discovery: Automatic A2A Agent Card generation exposes your agent's capabilities to other agents in the ecosystem, enabling seamless inter-agent communication and orchestration.

Asynchronous Task Architecture: Message-driven task management supports long-running operations with callback-based notifications. Perfect for research agents, data processing workflows, and event-driven automation. State persistence across Redis and other backends ensures reliability at scale.

Deterministic routing: Most frameworks place everything in the LLM's execution path, but this is often not optimal. Frequently, the better solution is through deterministic code, aka good old software engineering. For this reason, AgentUp allows for deterministic keyword based routing, where requests can natural language driven, but instead be sent to existing non-LLM services that utilize caching and other efficiency mechanisms.

Advanced Architecture with Production Aspirations

AgentUp is designed with production deployment in mind, featuring architecture patterns that will scale as the framework matures. While currently in alpha, the core security and extensibility features already provide a solid foundation for building serious AI agents.

Stay Updated

AgentUp development is moving at a fast pace 🏃‍♂️, for a great way to follow the project and to be instantly notified of new releases, Star the repo.

Get Started in Minutes

Installation

Install AgentUp using your preferred Python package manager:

pip install agentup

Create Your First Agent

Generate a new agent project with interactive configuration:

agentup init

Choose from available options and configure your agent's capabilities, authentication, and AI provider settings through the interactive prompts.

Start your Agent

Launch the development server and begin building:

agentup run

Your agent is now running at http://localhost:8000 with a full A2A-compliant JSON RPC API, security middleware, and all configured capabilities available.

Next Steps

Explore the comprehensive documentation to learn about advanced features, tutorials, API references, and real-world examples to get you building agents quickly.

Current Integrations

AgentUp Agents are able to present themselves as Tools to different frameworks, which brings the advantage of ensuring all Tool usage is consistent and secure, tracked and traceable.

• CrewAI, see documentation for details.

Open Source and Community-Driven

AgentUp is Apache 2.0 licensed and built on open standards. The framework implements the A2A (Agent-to-Agent) specification for interoperability and follows the MCP (Model Context Protocol) for integration with the broader AI tooling ecosystem.

Contributing - Whether you're fixing bugs, adding features, or improving documentation, contributions are welcome. Join the growing community of developers building the future of AI agent infrastructure.

Community Support - Report issues, request features, and get help through GitHub Issues. Join real-time discussions and connect with other developers on Discord.

What is DCO Bot?

We use the Developer Certificate of Origin (DCO) to keep our project legally sound and protect our community. Its very common in open source projects (The Linux Kernel, Kubernetes, Docker).

The DCO prevents issues like accidentally including proprietary code and ensures all contributors have the right to submit their changes.

This protects both contributors and users of the project.

How to sign commits

Simply add the -s flag when committing:

git commit -s -m "Add awesome new feature"

This adds a "Signed-off-by" line certifying you wrote the code or have permission to contribute it under Apache 2.0. You keep ownership of your contributions - no paperwork required!

---

License - Apache 2.0