Agentup

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.

When you need to customize, write your code as clean abstraction and load into AgentUp's runtime and inherit all of AgentUp's middleware and security. You can the manage your code as a depedency , along with any other communiity based plugins you used. No more fighting against a framework that breaks your app each time they changed something. Check out the AgentUp Plugin registry for a few of the current plugins on offer.

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.

MCP Support: AgentUp includes built-in support for Model-Context Protocol (MCP), allowing agents to seamlessly interact with various communication channels and APIs. Full support is available for STDIO, SSE and Streamable HTTP. Simply add a configuration in as much the same way as you would for Claude, Cursor or VSCode.

Multi Agent Type

Within AgentUp there are what we term multiple Agent types.

Reactive Agents: These agents respond to user inputs and events as single shot interactions, making them ideal for chatbots and interactive applications.

Iterative Agents: Designed for tasks that require multiple planning steps or iterations, making them ideal for research, these agents break down a goal into smaller, manageable tasks and execute them sequentially, maintaining context and state throughout the process. Goals must reach a confidence threshold before concluding.

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

Need a UI?

Grab hold of the AgentUp chat client to converse with your Agents through a simple interface using AgentUpChat

Check out the Docs!

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