Skip to main content

Declarative AI toolkit

Project description

Agent Building Toolkit - Agentify 🤖

PyPI Python Version License Open In Colab

Agentify is a lightweight, declarative-first Library for building AI agents in Python

KeyFeatures

  • Declarative agent definitions via YAML.
  • Multi-LLM support: OpenAI, Anthropic, and more.
  • Interactive CLI with TUI menu for exploring agents.
  • Programmatic agent creation and execution for custom workflows.
  • Lightweight, minimal dependencies: Click + Rich + PyYAML.

🚀 Getting Started

Prefer a hands-on walkthrough?

How it works

Define your agents in simple YAML files or programmatically, and run them using an interactive CLI. Agentify abstracts LLM provider integrations and provides a simplified developer experience.

Installation

pip install agentify-toolkit

Or install from source:

git clone https://github.com/backplane-software/agentify.git
cd agentify
pip install .

Quick Start

Note: To use Agentify you will require an API KEY from your AI Model Provider.

To add the API KEY to your environment:

agentify providers add <provider> # e.g. anthropic, xai, google, openai

Then, you can validate:

agentify providers list

1. Create an agent YAML

name: claude
description: AI Engineer
version: 0.1.0
model:
  provider: anthropic
  id: claude-sonnet-4-5
  api_key_env: ANTHROPIC_API_KEY
role: |
  You are an AI Security Engineer.
  Provide concise, practical answers with examples.

2 .Run a single agent

agentify run examples/agent.yaml

Overriding Model - you can pass a provider and model parameter to override the provider and model in the YAML file

agentify run examples/agent.yaml --provider=openai --model=gpt-5-nano

3. Run agents interactively from a folder

agentify run examples/agents

4. List agents interactively

agentify list agents

Programmatic Usage

Install agentify with pip install agentify and then import.

from agentify import Agent

def main():

    agent = Agent(
        name="Grok",
        description="X's Grok Agent",
        provider="x",
        model_id="grok-4",
        role="You are an AI Security Architect specialising in X AI Grok models"
    )

    response = agent.run("Which AI LLM is the best in 1 sentence ?")
    print(response)

if __name__ == "__main__":
    main()

CLI Reference

Command Example
Run agent from YAML agentify run <agent.yaml>
Run all YAML Agents in folder agentify run <folder>
List all YAML Agents in folder agentify list <folder>

Adding LLM API Keys

To use the LLM Model providers, you will need an API key and they will need to be made available in your environment.

Implemented providers:

Provider Instruction
OpenAI export OPENAI_API_KEY="your_api_key_here"
Anthropic export ANTHROPIC_API_KEY="your_api_key_here"
Gemini export GEMINI_API_KEY="your_api_key_here"
GROK export XAI_API_KEY="your_api_key_here"
Bedrock export AWS_BEARER_TOKEN_BEDROCK

For Windows: $env:<Provider>_API_KEY="YOUR_API_KEY"

License

Agentify is licensed under the Apache License, Version 2.0. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentify_toolkit-0.2.1.tar.gz (38.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentify_toolkit-0.2.1-py3-none-any.whl (41.0 kB view details)

Uploaded Python 3

File details

Details for the file agentify_toolkit-0.2.1.tar.gz.

File metadata

  • Download URL: agentify_toolkit-0.2.1.tar.gz
  • Upload date:
  • Size: 38.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for agentify_toolkit-0.2.1.tar.gz
Algorithm Hash digest
SHA256 6609a702c403f6facc014a78e4cea05b520b65f4d302994ef0ca8ffe2602c5c7
MD5 60464e17f697433afff025b4dc4bdd38
BLAKE2b-256 ae7db8a6e93d551c36ba2947092878c320abbcd2a762e791317b03dd0b79e827

See more details on using hashes here.

File details

Details for the file agentify_toolkit-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for agentify_toolkit-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4f302bb1517bd51343f76bcf5cb8273bb2e6be64c28fd6a8de197f90b40d4120
MD5 a5a0f1daf528dbaeb633a01e02507959
BLAKE2b-256 a90dbbcf60a6ddeba3538180ded9d700d5106e3b64eaa890948b56df57cc499e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page