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.1.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.1-py3-none-any.whl (40.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentify_toolkit-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 c0e40ec24358906abfad9284c9572c3692d4d7ab495fba8e99e5ff8c5f036a5e
MD5 414832b33fdeb97bfdaefe9d8968228d
BLAKE2b-256 17d71a97c6f2a478a20eb3a36d8f87f041a7ffbc8f30daf13b4d090370b21a55

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentify_toolkit-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0f4ecacb6e83095aab1934f35bd2f1a61fa8d1d767f4b35835f71b0bc12aed40
MD5 286012f452ac0d8e252b138c7b7d5d96
BLAKE2b-256 0c3db3666ef781adf29b44d9fa3476402058e91f55625585cfa8603f86ac12e4

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