{"id":"363f1415-bb7b-421c-ae30-fe9f2e2ef5cd","slug":"arpan404-afk","kind":"skill","name":"afk","summary":"Agent Forge Kit: Build powerful agents with beautiful DX","owner":"arpan404","repoUrl":"https://github.com/arpan404/afk","license":"MIT","licenseTier":"permissive","trust":"community","stars":4,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-02-11T02:41:31.000Z","addedAt":"2026-10-21T16:48:56.723Z","logoUrl":"https://avatars.githubusercontent.com/u/92071427?u=8e99ed947888d415494b1e5b7364f4e6ef61ce61&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T23:29:30.209Z","sample":false,"url":"https://conduits.dev/tools/arpan404-afk","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Agent Forge Kit (AFK) Python SDK\n\nAFK is a Python 3.13+ SDK for building reliable AI agents with typed tools, runtime controls, memory, streaming, evals, and observability.\n\nDocumentation: [afk.arpan.sh](https://afk.arpan.sh)\n\n## Install\n\nThe distribution package is `afk-py`; the import package is `afk`.\n\n```bash\npython -m pip install afk-py\n```\n\nFor repository development:\n\n```bash\npython -m pip install --upgrade pip\npython -m pip install -e . pytest\n```\n\n## Quick Start\n\n```python\nfrom afk.agents import Agent\nfrom afk.core import Runner\n\nagent = Agent(\n    name=\"ops-bot\",\n    model=\"gpt-4.1-mini\",\n    instructions=\"You are a helpful SRE assistant.\",\n)\n\nresult = Runner().run_sync(\n    agent,\n    user_message=\"What is an error budget?\",\n)\n\nprint(result.state)\nprint(result.final_text)\n```\n\n## Core Model\n\nAFK separates agent behavior from runtime execution:\n\n- `Agent` describes identity, model, instructions, tools, subagents, skills, MCP servers, and fail-safe limits.\n- `Runner` executes agents synchronously, asynchronously, or as a stream.\n- Runtime subsystems provide LLM adapters, tool execution, memory, queues, policy, and telemetry.\n- `AgentResult` records final text, state, run/thread ids, tool/subagent executions, usage, and cost.\n\n## Add a Tool\n\n```python\nfrom pydantic import BaseModel\n\nfrom afk.agents import Agent, FailSafeConfig\nfrom afk.core import Runner\nfrom afk.tools import tool\n\n\nclass LookupArgs(BaseModel):\n    order_id: str\n\n\n@tool(args_model=LookupArgs, name=\"lookup_order\", description=\"Look up an order.\")\ndef lookup_order(args: LookupArgs) -> dict:\n    return {\"order_id\": args.order_id, \"status\": \"shipped\"}\n\n\nagent = Agent(\n    name=\"support-agent\",\n    model=\"gpt-4.1-mini\",\n    instructions=\"Use lookup_order when users ask about orders.\",\n    tools=[lookup_order],\n    fail_safe=FailSafeConfig(max_steps=8, max_tool_calls=4, max_total_cost_usd=0.10),\n)\n\nresult = Runner().run_sync(agent, user_message=\"Where is order A123?\")\nprint(result.final_text)\n```\n\n## Common Commands\n\n```bash\nPYTHONPATH=src pytest -q\nPYTHONPATH=src pytest -q tests/agents/test_agent_runtime.py\nruff check src tests\nruff format src tests\n./scripts/docs_dev.sh\n./scripts/build_agentic_ai_assets.sh\n```\n\n## Install AFK Codex Skills\n\nInstall AFK skills with Vercel's Skills CLI:\n\n```bash\nnpx skills add https://github.com/arpan404/afk --skill afk-coder\nnpx skills add https://github.com/arpan404/afk --skill afk-maintainer\n```\n\nThe `skills` CLI installs the selected skill into the configured agent environment, including Codex.\n\n## Docs Paths\n\n- Start building: [Quickstart](https://afk.arpan.sh/library/quickstart)\n- Guided tutorial: [Learn AFK in 15 Minutes](https://afk.arpan.sh/library/learn-in-15-minutes)\n- Public imports: [API Reference](https://afk.arpan.sh/library/api-reference)\n- Contributor workflow: [Developer Guide](https://afk.arpan.sh/library/developer-guide)\n- Environment variables: [Environment Variables](https://afk.arpan.sh/library/environment-variables)\n\n## When to Use AFK\n\nUse AFK when your agent needs tools, multi-step execution, streaming, memory, approvals, cost limits, telemetry, evals, queues, or provider portability.\n\nA direct provider SDK may be simpler for one-off single-turn text generation.\n"}