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.1.2.tar.gz (37.9 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.1.2-py3-none-any.whl (40.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentify_toolkit-0.1.2.tar.gz
  • Upload date:
  • Size: 37.9 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.1.2.tar.gz
Algorithm Hash digest
SHA256 2a01f1178bc8a7e2fcf6163179e5827a409aecf80e4f3717b63fed5e758d3d6a
MD5 942d33461aff019da3eb695de3003b6b
BLAKE2b-256 f753240ae9852c9f5331ea453aece8778bfd6d16da9d3d473f170cc349e6b827

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentify_toolkit-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c2b6b29cbdad606c09b5897c7531bce29e7edc88f3eaa27439e697e150ab9a6a
MD5 da87acfed05bc7dfc6acc74f6650966a
BLAKE2b-256 7f6f47688c26c07d9db27ea13455745abf54e4e5948d9c339eb290a5e72f6c5a

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