AgentiCore — Python Agentic Library

What Is AgentiCore?

AgentiCore is a production-grade, open-source Python library for building scalable agentic AI systems. It provides:

• A composable core framework — build any agent type without being forced into a specific pattern
• Built-in reasoning strategies — ReAct, Plan-Execute, Reflection, Tree-of-Thought, and custom
• Tiered memory system — working, episodic, semantic (RAG), and procedural memory
• Type-safe tool system — define, validate, and compose tools with full schema enforcement
• Multi-agent orchestration — supervisor, pipeline, fan-out, debate, swarm patterns
• Built-in Web UI — visual agent builder, tool creator, real-time run viewer, trace inspector
• Plugin ecosystem — extend anything without forking the library
• First-class observability — structured tracing, cost tracking, step logging out of the box

Design Philosophy

1. Explicit Over Magic

No hidden auto-wiring. Every component is explicitly configured. If an agent calls a tool, you see exactly where and why.

2. Composable, Not Opinionated

The core module is pure Python with zero mandatory dependencies. LangGraph, Qdrant, OpenAI — all are optional integrations, not requirements.

3. Schema-First

Every interface (tool inputs/outputs, agent state, memory schema, API payloads) is defined with strict types before implementation. Prevents entire classes of bugs.

4. Production-Ready From Day One

Retries, timeouts, cost budgets, circuit breakers, human-in-the-loop, and audit logging are built-in — not afterthoughts.

5. Observable By Default

Every agent step, tool call, LLM invocation, and memory operation emits structured events. You never wonder "what is the agent doing right now?"

6. Developer Experience First

The Web UI exists so that non-engineers can configure, run, and monitor agents without writing code. But engineers get full programmatic control of everything the UI does.

Library Name & Namespace

Package name:  hembramagenticcore
Import as:     import hembramagenticcore as ag
PyPI slug:     hembramagenticcore
CLI command:   hembramagenticcore

Core Value Propositions

Quick Concept Demo (Target API)

import hembramagenticcore as ag

# 1. Define a tool with a decorator
@ag.tool(description="Search the web for current information")
def search_web(query: str, max_results: int = 5) -> list[ag.SearchResult]:
    ...

# 2. Build an agent
agent = (
    ag.AgentBuilder()
    .name("ResearchAgent")
    .llm(ag.LLM.GPT4O)
    .reasoning(ag.ReAct)
    .tools([search_web, ag.tools.CodeExecutor()])
    .memory(ag.memory.Qdrant(url="localhost:6333"))
    .max_steps(20)
    .build()
)

# 3. Run it
result = agent.run("Summarize key AI releases from Q1 2026")
print(result.output)
print(result.trace)   # Full step-by-step trace
print(result.cost)    # Token cost in USD

# 4. Or launch the Web UI
ag.serve(agents=[agent], port=8080)

License & Contributing

• License: Apache 2.0 (permissive, commercial-friendly)
• Contributing: See CONTRIBUTING.md
• Code of Conduct: See CODE_OF_CONDUCT.md