akgentic-agent
LLM-driven collaborative agents for the
Akgentic multi-agent framework
(open-source bundle). BaseAgent composes the actor runtime, LLM integration, and tool infrastructure into a
single unit where agents communicate through a typed message protocol and route messages
to each other via structured LLM output.
Table of Contents
- Overview
- Installation
- Quick Start
- Communication Model
- Message Protocol
- Team Composition
- Configuration
- Tool Channels
- Examples
- Documentation
- Development
- License
Overview
Each agent is an Akgent actor. When it receives an AgentMessage, it runs a REACT loop
(ReactAgent.run_sync) and returns a StructuredOutput — a list of Request objects
that each name a recipient and a message type. The framework resolves the recipients and
delivers the messages; the LLM navigates the conversation graph.
Human
│ AgentMessage(content, type="request")
▼
HumanProxy ──send()──► BaseAgent (Manager)
│
receiveMsg_AgentMessage()
│ prepend reply protocol to the prompt:
│ "You received a request from @Human. Carry out the
│ task, then respond to @Human. ..."
│
process_message(prompt, sender)
│
act(prompt, StructuredOutput)
│
├─ expand !!glob_pattern refs (if WorkspaceTool present)
└─ ReactAgent.run_sync(prompt, output_type=StructuredOutput)
│
StructuredOutput.messages = [
Request(recipient="@Assistant", message_type="instruction", message="..."),
Request(recipient="Developer", message_type="request", message="..."),
]
│
for each Request:
├─ "@Name" → resolve to existing actor
└─ "Role" → hire_member(role) → create actor
│
send AgentMessage(content=request.message,
type=request.message_type)
└─ the RAW message — the sender does not enrich it.
The receiving agent prepends its own reply
protocol when it runs the loop above.
Installation
Published on PyPI. Python 3.12 or newer.
uv add akgentic-agent
# or
pip install akgentic-agent
That is the whole install. akgentic-core, akgentic-llm, akgentic-tool and
pydantic-ai come with it as ordinary dependencies — no workspace checkout, no
submodules.
As part of the framework bundle
akgentic-framework is the meta-distribution that pins every akgentic package
at versions built and tested together. Install akgentic-agent through it when
you want the release-wide pin rather than a single package:
pip install "akgentic-framework[agent]" # this package + its closure, release-pinned
pip install "akgentic-framework[all]" # the whole framework
Working on the package itself
To develop akgentic-agent rather than use it, clone the open-source bundle
akgentic-framework, which
carries every package together as submodules:
git clone git@github.com:b12consulting/akgentic-framework.git
cd akgentic-framework
git submodule update --init
# uncomment the two "SOURCE MODE" blocks in pyproject.toml
uv sync
Source mode resolves akgentic-* to the local checkouts, editable.
Quick Start
import time
from akgentic.agent import AgentConfig, AgentMessage, BaseAgent, HumanProxy
from akgentic.core import ActorSystem, AgentCard, BaseConfig, Orchestrator
from akgentic.llm import ModelConfig, PromptTemplate
# Actor runtime + Orchestrator
actor_system = ActorSystem()
orchestrator_addr = actor_system.createActor(
Orchestrator, config=BaseConfig(name="@Orchestrator", role="Orchestrator")
)
orchestrator_proxy = actor_system.proxy_ask(orchestrator_addr, Orchestrator)
# Define and register a role blueprint.
# NOTE: there is no `role=` keyword on AgentCard — `card.role` is a read-only
# property reading `config.role`, which is the single source of truth.
manager_card = AgentCard(
description="Project manager who coordinates specialists",
skills=["coordination", "delegation"],
agent_class="akgentic.agent.BaseAgent",
config=AgentConfig(
name="@Manager",
role="Manager",
prompt=PromptTemplate(template="You are a project manager. Delegate to specialists."),
model_cfg=ModelConfig(provider="openai", model="gpt-4.1"),
),
routes_to=["Developer", "QA"], # roles this agent can hire on demand
)
# Register role blueprints — accepts a list of AgentCard
orchestrator_proxy.register_agent_profiles([manager_card])
# Human entry point
human_addr = orchestrator_proxy.createActor(
HumanProxy, config=BaseConfig(name="@Human", role="Human")
)
human_proxy = actor_system.proxy_tell(human_addr, HumanProxy)
# Instantiate Manager and send the first message
manager_addr = orchestrator_proxy.createActor(
BaseAgent, config=manager_card.get_config_copy()
)
time.sleep(0.3)
# Send a message from the human to the manager
human_proxy.send(manager_addr, AgentMessage(content="Plan the next sprint."))
Communication Model
Every message in the system carries an intent — a declaration of what the sender expects from the recipient. Intent is the core abstraction that drives conversation flow between agents.
Intent: the driving concept
When an agent sends a message, it declares its intent via a message_type:
| Intent | Meaning | Expected reply |
|---|---|---|
request |
"Do this and bring me the result" | response |
instruction |
"Do this (possibly for a third party)" | acknowledgment |
response |
"Here is what you asked for" | Optional |
notification |
"FYI — no action needed" | None |
acknowledgment |
"Got it" | None |
The key distinction is who needs the result: a request means "bring it back to
me", an instruction means "go do this on my behalf".
Intent flows through the system in two complementary ways:
-
When sending — The LLM chooses an intent for each outbound
Request.process_message()delivers the rawrequest.messageas anAgentMessagewhosetypefield carries that intent unchanged. The sender does not rewrite the content. -
When receiving —
receiveMsg_AgentMessage()prepends a one-line reply protocol, keyed on the incomingtypeviaREPLY_PROTOCOLS, to the raw content before handing it to the LLM. The guidance is therefore always the one matching the intent that agent received, and it reaches the LLM through the prompt — not through the output schema.
AgentMessage
All inter-agent communication uses a single AgentMessage type:
class AgentMessage(Message):
type: Literal["request", "response", "notification", "instruction", "acknowledgment"] = "request"
content: str
The type field carries the sender's intent through the system. The first message is
typically sent by an external system (e.g., HumanProxy) as a request with plain
content. From there, each agent's LLM decides the intent it attaches to every outbound
message.
StructuredOutput and Request
Each LLM call produces a StructuredOutput with a list of outbound Request objects:
class Request(BaseModel):
message_type: Literal[
"request", # ask recipient to perform a task and reply to you with the result
"instruction", # direct recipient to perform a task, you may ask for acknowledgement
"response", # respond to a previous request
"notification", # send information to the recipient, no reply is expected
"acknowledgment", # confirm receipt of an instruction, no reply is expected
]
message: str
recipient: str # "@MemberName" (existing actor) or "RoleName" (triggers hiring)
class StructuredOutput(BaseModel):
messages: list[Request] = []
The LLM chooses both the recipient and the intent for every outbound message.
Request.message_type flows directly into the delivered AgentMessage.type, so every
receiver sees the sender's intent as first-class data.
An empty list means the agent has nothing more to send — but the LLM still runs. A
notification or acknowledgment means the output list should be empty, not that
the LLM call is skipped. The message is still processed and added to the agent's context
for future interactions.
Static Schema + Prompt-Carried Reply Protocol
act() reasons against the static StructuredOutput type directly — there is no
per-call subclass and no type() metaprogramming on the hot path:
output = self._react_agent.run_sync(prompt, deps=self, output_type=StructuredOutput)
Request.recipient is a plain string with no enum constraint. Recipient validity is
enforced at routing time in process_message(), not in the schema:
| Recipient format | Resolution |
|---|---|
@MemberName |
get_team_member(name) → direct send (skipped if not found) |
RoleName |
hire_member(role) → create actor → send |
The reply-protocol guidance lives where the LLM actually reads it — the prompt.
receiveMsg_AgentMessage() prepends a one-line protocol (keyed on the incoming message
type via REPLY_PROTOCOLS) to the raw content before handing it to process_message():
You received a request from @Human. A reply is expected: respond to @Human with the result.
<raw message content>
Note: This supersedes the schema-constrained-recipient + docstring-injection mechanism from Story 5.1 / ADR-004. The intent-driven 5-type protocol is unchanged — only its enforcement moved from a per-call schema to the prompt + routing-time validation.
Routing and Delivery
process_message() resolves each Request.recipient (see the table above) and sends the
raw request.message as an AgentMessage. The sender does not enrich the content —
the reply-protocol prefix is added by the receiving agent's receiveMsg_AgentMessage(),
so the guidance is always keyed to the intent that agent actually received:
# In the receiver's receiveMsg_AgentMessage(), before process_message():
prompt = f"You received a request from @Manager. {reply_protocol}\n\n{message.content}"
On LLMUsageLimitError, the agent escalates via notify_human() to the team's
user-proxy member — found structurally through ActorAddress.is_user_proxy, so any
role string works; when the team has none, the notice is logged and dropped.
HumanProxy
HumanProxy extends UserProxy from akgentic-core. It serves two roles:
- Message sink —
receiveMsg_AgentMessage()logs receipt. The base implementation publishes nothing of its own; subscribers see the content through theSentMessagethe sending agent emits. Override the hook to queue for a console printer, a WebSocket to a frontend, WhatsApp, email, etc. - Human input bridge —
process_human_input()routes a human's reply back tomessage.senderas anAgentMessagewithtype="response".
# Send a message from the human to an agent
human_proxy = actor_system.proxy_tell(human_addr, HumanProxy)
human_proxy.send(agent_addr, AgentMessage(content="Do X"))
# Route a human reply back to the agent that asked
human_proxy.process_human_input("My answer", original_message)
Message Protocol
The 5-type intent protocol controls conversation flow. When an incoming message is
received, the matching REPLY_PROTOCOLS instruction is prepended to the user prompt
(not the output schema), so the LLM reads the guidance inline with the content:
| Intent | Receiver instruction (REPLY_PROTOCOLS) |
|---|---|
request |
"A reply is expected: respond to {sender} with the result." |
response |
"This is a reply to something you asked. Take it into account and continue." |
instruction |
"Carry it out; acknowledge to {sender} only if asked to." |
notification |
"Informational message. No reply is expected." |
acknowledgment |
"Receipt confirmed. No further action needed." |
These lines state message mechanics only — what kind of message arrived, and whether a
reply is expected. They deliberately say nothing about who should do the work or whether
to delegate, because they sit at the most salient position in every agent's prompt, in every
team. Team policy that is stated there is stated to everyone at once: the earlier request
text read "Carry out the task, then respond to {sender}. You may also delegate to others",
and that single line is what made coordinators do their specialists' work. Wording it the
other way round is the same mistake with the sign flipped — it makes specialists fan out to
each other. Division of labour is per-role, so it belongs in the agents' own prompts.
The protocol is soft guidance, not framework enforcement. The LLM is guided to send no
further messages for notification and acknowledgment, but the framework processes
whatever the LLM returns. This is intentional: LLMs are probabilistic, and rigid
enforcement would be brittle.
No reply does not mean no processing. When the protocol says "return an empty list", the LLM still runs — it absorbs the message into its context, which may inform future decisions. The empty list simply means no outbound messages are sent.
Team Composition
AgentCard
Declarative role definition registered with the Orchestrator. Acts as a blueprint: agents can be instantiated from it on demand without hard-coding actor addresses.
AgentCard(
description="Writes and reviews code",
skills=["python", "testing"],
agent_class="akgentic.agent.BaseAgent", # FQCN string or class reference
config=AgentConfig(name="@Developer", role="Developer"),
routes_to=["Reviewer", "Tester"], # roles this agent can hire
)
role is not a constructor keyword. AgentCard.role is a read-only property that reads
config.role, so that config field is the single source of truth. Passing role= to the
constructor is silently ignored by Pydantic — the card would end up with whatever
config.role says, or an empty role if you set neither.
register_agent_profiles([card, ...]) stores cards in the Orchestrator so any agent can
hire a role by name without knowing the class.
AgentCard.get_config_copy() returns a fresh AgentConfig suitable for createActor().
Dynamic Hiring
When process_message() sees recipient="Developer" (no @ prefix), it calls
hire_member("Developer"), which resolves the registry's typed hire_member command
(TeamTool) and invokes it. That command:
- Looks up the
AgentCardfor"Developer"in the Orchestrator - Calls
createActor(agent_class, config=card.get_config_copy()) - Returns the new actor address for immediate message delivery
If no hire_member command is registered — TeamTool was removed from config.tools — the
method raises RuntimeError rather than failing silently.
The LLM in the sending agent triggers this transparently by naming a role instead of a team member.
EventSubscriber
Attach an EventSubscriber to the Orchestrator to observe all messages and events:
from akgentic.core import EventSubscriber
from akgentic.core.messages import Message
from akgentic.core.messages.orchestrator import EventMessage, SentMessage
from akgentic.llm import ToolCallEvent
class MessagePrinter(EventSubscriber):
def on_message(self, message: Message) -> None:
if isinstance(message, SentMessage):
print(f"[{message.sender.name}] → {message.recipient.name}: {message.message.content}")
elif isinstance(message, EventMessage) and isinstance(message.event, ToolCallEvent):
print(f"TOOL: {message.event.tool_name}")
orchestrator_proxy.subscribe(MessagePrinter())
Configuration
AgentConfig
Extends BaseConfig from akgentic-core:
| Field | Type | Default | Description |
|---|---|---|---|
prompt |
PromptTemplate |
PromptTemplate() |
Agent backstory rendered into AgentState.backstory and injected as LLM system prompt |
model_cfg |
ModelConfig |
ModelConfig() |
LLM provider, model name, API settings |
runtime_cfg |
RuntimeConfig |
RuntimeConfig() |
Retries, tool-call end strategy, parallel tools, HTTP client settings |
run_usage_limits |
RunUsageLimits |
RunUsageLimits() |
Budget for one run() — token and request caps that reset every run |
agent_usage_limits |
AgentUsageLimits |
AgentUsageLimits() |
Budget for the agent's whole lifetime — runs and tokens, accumulated across every run |
compaction_cfg |
CompactionConfig |
CompactionConfig() |
Context-compaction strategy and auto-trigger (opt-in; off unless model_cfg.context_length is set) |
tools |
list[ToolCard] |
[] |
Tool cards; TeamTool is always prepended automatically |
Usage limits: two tiers
The two budgets answer different questions, and both are carried into the ReactAgent that
BaseAgent builds. Neither is enforced in akgentic-agent — this package configures,
akgentic-llm enforces.
| tier | class | bounds | enforced by |
|---|---|---|---|
| run | RunUsageLimits |
one run() call — requests, tool calls and tokens within it |
pydantic-ai, mid-run; counts reset every run |
| agent | AgentUsageLimits |
the agent's whole lifetime — run() calls and cumulative tokens |
ReactAgent, pre-flight before each run |
from akgentic.agent.config import AgentConfig
from akgentic.llm import AgentUsageLimits, ModelConfig, RunUsageLimits
config = AgentConfig(
name="@Manager",
role="Manager",
model_cfg=ModelConfig(provider="openai", model="gpt-4.1"),
run_usage_limits=RunUsageLimits(run_request_limit=50, total_tokens_limit=100_000),
agent_usage_limits=AgentUsageLimits(agent_request_limit=200, total_tokens_limit=2_000_000),
)
Both defaults are safe to leave alone. RunUsageLimits() keeps a 50-request-per-run brake;
AgentUsageLimits() is all-None, and an all-None budget never blocks — that is why the
field is never None itself, and why adding a lifetime cap is opt-in rather than a
behaviour change.
The agent tier survives a resume. Its counters are not persisted and are not part of
AgentState. On restore, ReactAgent recomputes them from the replayed usage events the
team restorer already feeds through init_llm_context() — so an agent that has spent 180 of
its 200 runs comes back with 20 left, not 200. Two consequences worth knowing:
- The lifetime token limits bound where a run may start, not where it may end. A run's cost is unknown until it completes, so the run that crosses the line finishes and only the next one is refused.
agent_request_limitis consumed before the call executes, so a run that fails partway still counts against the lifetime budget.
A retrying tool now costs an extra model turn. Under end_strategy="exhaustive" (the
default), pydantic-ai v2 suppresses an output produced in the same round as a function tool
that raised ModelRetry, and keeps the run open for another model turn. Since agents here
routinely emit a StructuredOutput alongside a tool call, and tools raise ModelRetry by
design, that second turn is charged to both tiers — so an agent near either budget can
trip a limit on a turn that previously completed. Budget for it when sizing tight limits.
Both tiers raise the same UsageLimitError, so a caller that already catches it needs no
change to handle the new tier.
Migrating from usage_limits
AgentConfig.usage_limits was the single pre-split budget. It is now the run tier under a
new name:
# before
AgentConfig(usage_limits=UsageLimits(request_limit=50, total_tokens_limit=100_000))
# after
AgentConfig(run_usage_limits=RunUsageLimits(run_request_limit=50, total_tokens_limit=100_000))
The old spelling still works: passing usage_limits= emits a DeprecationWarning and populates
run_usage_limits, and reading config.usage_limits returns the run tier. Passing both
usage_limits= and run_usage_limits= raises ValueError rather than silently picking one.
Both are removed in akgentic-agent 2.0.0.
UsageLimits — the pre-split class itself — is a separate, akgentic-llm-owned deprecated alias
of RunUsageLimits. It still ships and still warns; its removal is not scheduled for a named
release. Only the two AgentConfig shims above carry a fixed removal target.
AgentState
Runtime state extending BaseState:
| Field | Type | Description |
|---|---|---|
backstory |
str |
config.prompt rendered at on_start(), injected as LLM system context on every call |
Tool Channels
ToolFactory organises tool cards into three channels:
| Channel | Consumer | Examples |
|---|---|---|
TOOL_CALL |
LLM via pydantic-ai tools | hire_members(), fire_members(), web_search(), workspace_read() |
SYSTEM_PROMPT |
LLM system prompt (per call) | team roster, role profiles, backstory, mailbox notifications |
COMMAND |
CommandRegistry — in-agent Python and /-prefixed messages |
hire_member, fire_member, team_members, team_roles, planning_summary |
TeamTool is always prepended to config.tools if not already present, ensuring every
BaseAgent can hire and fire members.
The Command Registry
on_start() builds one CommandRegistry from every COMMAND-channel capability of the
agent's tool cards, adds compact and clear as command-only built-ins, and announces the whole
set once as a CommandsAnnouncedEvent:
self._command_registry = tool_factory.get_command_registry(
extra_commands=[self.compact, self.clear]
)
self.notify_event(
CommandsAnnouncedEvent(
agent=self.myAddress,
commands=self._command_registry.descriptors(),
)
)
Commands are keyed by the callable's __name__. The canonical names are therefore
hire_member, fire_member, team_members, … — there is no cmd_ prefix on any of them.
Two surfaces reach the same table:
| Surface | Call | Returns |
|---|---|---|
| human / text | registry.dispatch("/hire_member Developer") |
str — the result, rendered |
| typed / in-agent | registry.callable("hire_member")("Developer") |
the command's native value (here an ActorAddress) |
registry.has(name) tests availability before either call, and registry.descriptors() returns
serializable discovery metadata — name, description, argument schema, and owning tool card.
BaseAgent uses both surfaces itself: hire_member() resolves the typed callable, and act()
expands media references the same way.
if not self._command_registry.has("hire_member"):
raise RuntimeError("hire_member command not available — TeamTool not configured")
hire = self._command_registry.callable("hire_member")
return cast(ActorAddress, hire(role))
Slash commands: how a human drives an agent
A message whose content starts with / is intercepted in receiveMsg_AgentMessage() before
the LLM path and handed to _dispatch_command(). That method dispatches the text, replies to the
sender with a notification AgentMessage carrying the result, and records one
human-attributed operator action in the agent's LLM context — so the agent reasons about what the
human did on its next turn, without mistaking it for its own tool call.
human_addr.send(manager_addr, AgentMessage(content="/team_members"))
human_addr.send(manager_addr, AgentMessage(content="/hire_member DevOpsEngineer"))
human_addr.send(manager_addr, AgentMessage(content="/fire_member @DevOpsEngineer456"))
An unrecognised leading token raises CommandNotRecognized, which _dispatch_command() swallows
so the message falls through to the normal LLM path with its original content — a sentence that
happens to start with a slash is never lost, and nothing is injected into the context. Failures
after a command has been identified (missing or malformed arguments, or the command body
raising) are caught inside dispatch() and returned as a result string; those never fall back to
the LLM.
Arguments are shlex-split and coerced against the command's signature. A token is treated as a
keyword only when the text before its first = names a real parameter, so
/hire_member Developer name=@Ada binds both, while a positional value containing = is left
intact.
Which commands exist
The registry contents follow from the tool cards attached to the agent:
| Command | Provided by | Description |
|---|---|---|
hire_member(role, name=None) |
TeamTool |
Hire by role; native return is the new ActorAddress |
fire_member(name) |
TeamTool |
Fire a member by name |
team_members() |
TeamTool |
Current team roster |
team_roles() |
TeamTool |
Available roles and descriptions |
planning_summary() |
PlanningTool |
Full team planning text |
get_planning_task(task_id) |
PlanningTool |
Single planning task by ID |
search_planning(...) |
PlanningTool |
Search the shared task board |
compact() / clear() |
BaseAgent built-ins |
Compact or clear the conversation context |
Do not hand-transcribe this table into your own code: read the set from
registry.descriptors(), or from the CommandsAnnouncedEvent the agent emits at start-up. Those
cannot drift from the registry; a copied list can.
Methods on the Pykka proxy
Separately from the command channel, BaseAgent's own public methods are reachable through
actor_system.proxy_ask(agent_addr, BaseAgent):
| Method | Returns | Description |
|---|---|---|
get_usage_summary(by_run) |
AgentUsageSummary |
Aggregated LLM usage and cost; queries the orchestrator for LlmUsageEvents and folds them via aggregate_usage() from akgentic.llm. Pass by_run=True for a per-run breakdown. |
Media Expansion
When the registry carries an _expand_media_refs command — WorkspaceTool is what provides it —
act() expands inline file references before the LLM call:
!!file.png → BinaryContent injected into the prompt
!!"my screenshot.png" → same, for paths with spaces
!!*.png → glob — every matching image, sorted by path
!!report.pdf → "!!report.pdf[=> Use workspace_read tool]" forwarded to the LLM
!!nonexistent.png → "!!nonexistent.png[Error: no image found in the workspace]"
Expansion happens in act() before run_sync(), and only when the expansion actually changed
something: if the command returns the prompt unchanged, the plain string is sent as-is. Errors and
document hints are forwarded to the LLM rather than silently dropped. Agents whose registry has no
_expand_media_refs are unaffected — the block is a no-op.
Examples
cd packages/akgentic-agent
uv run python examples/simple_team.py
| Script | Topic |
|---|---|
simple_team.py |
Three-role interactive team with search, workspace, planning, /commands, and /usage for per-agent cost reporting via EventSubscriber |
See the Examples README for full descriptions and running instructions.
Documentation
- Agent Collaboration System — Collaboration model, routing mechanics, delegation patterns, and typed protocol walkthrough
Development
Prerequisites
- Python 3.12+
- uv package manager
Setup
From this repository's root — akgentic-core, akgentic-llm and akgentic-tool
resolve from PyPI under the floors in pyproject.toml. This is what CI does:
uv venv
uv pip install -e ".[dev]"
To exercise this package against unreleased sibling code, work from the akgentic-framework bundle in source mode instead — see Working on the package itself.
Commands
From this repository's root:
# Run tests
uv run pytest tests/
# Run tests with coverage
uv run pytest tests/ --cov=akgentic.agent --cov-fail-under=80
# Lint
uv run ruff check src/ tests/
# Format
uv run ruff format src/ tests/
# Type check
uv run mypy src/
addopts = "-m 'not integration'" deselects the integration tests by default: they make real LLM
calls (gated by OPENAI_API_KEY) and poll for actor quiescence. Run them explicitly with
uv run pytest tests/ -m integration.
CI Pipeline
The package uses GitHub Actions for continuous integration. On every push, on pull requests
against master, and on manual dispatch, the pipeline:
- Checks out this repository only — no workspace, no submodules
- Installs uv and Python 3.12, and creates a virtualenv
- Installs the package and its dev extra with
uv pip install -e ".[dev]", so the sibling akgentic packages come from PyPI at their declared floors - Runs mypy on
src/(strict type checking) - Runs ruff check on
src/ - Runs pytest on
tests/with coverage overakgentic.agent(--cov-fail-under=80) - Updates the coverage badge gist — only on
masterpushes
Because step 3 resolves the siblings from PyPI, a change that depends on an unreleased
akgentic-core/llm/tool commit will be red here until that package ships, even when the
workspace is green locally. That is a merge-order signal, not a defect in this package.
Note: No pre-commit hooks are configured in this package. Quality checks run exclusively in CI.
Project Structure
src/akgentic/agent/
__init__.py # Public API: BaseAgent, AgentConfig, HumanProxy, AgentMessage
agent.py # BaseAgent — actor + LLM + tool composition, routing logic
config.py # AgentConfig, AgentState
human_proxy.py # HumanProxy — human-in-the-loop bridge
messages.py # AgentMessage with typed protocol
output_models.py # StructuredOutput, Request, REPLY_PROTOCOLS
examples/ # Runnable examples with README
tests/ # Tests organised by module
docs/
agent-collaboration.md
License
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
Dual licensing & CLA — Akgentic is available under the AGPL-3.0 open-source license. A commercial license is also planned for organizations that require alternative terms. Contact Yuma for more information. External contributions will be accepted once a Contributor License Agreement (CLA) is in place. Until then, please hold off on submitting pull requests.
Metadata
Release files for akgentic-agent 1.6.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| akgentic_agent-1.6.7.tar.gz | 118.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| akgentic_agent-1.6.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 159.8 kB
Release files / akgentic_agent-1.6.7.tar.gz
| Download URL | akgentic_agent-1.6.7.tar.gz |
|---|---|
| Size | 118.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e338cf29c23b45eb2296c4c5be018baf1f35e5d87774bf8cf5a392cf02df2440
|
|
BLAKE2b-256 checksum How to use checksums |
77e92003d9ff4e87c36b1387f42a1ef6f689dac350e6d1cccb302abede88392f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 19, 2026.
Transparency logRelease files / akgentic_agent-1.6.7-py3-none-any.whl
| Download URL | akgentic_agent-1.6.7-py3-none-any.whl |
|---|---|
| Size | 41.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7b3b81774f88fc63a3ee30d01f90539b0e684795cfddcf0f2252c5423e693a92
|
|
BLAKE2b-256 checksum How to use checksums |
92f6078b46b412aca4d2e5d4987f7f09c48b04366e678e13a935e45ac135c0a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 19, 2026.
Transparency log