WireAgent

Open source, self-hosted agent lifecycle framework.

WireAgent gives you full control over how AI agents are created, deployed, monitored, and retired — all on your own infrastructure. No vendor lock-in, no data leaving your servers.

Why WireAgent?

• Self-hosted — Run everything on your own infrastructure. Your data stays yours.
• Full lifecycle management — Create, configure, deploy, monitor, scale, and retire agents through a single framework.
• Framework agnostic — Bring your own LLM provider, tools, and integrations.
• Observable — Built-in hooks for logging, metrics, and tracing at every stage of the agent lifecycle.
• Composable — Wire agents together into pipelines, teams, and hierarchies.

Quick Start

npm install wireagent

const { Agent, Runtime } = require('wireagent');

// Define an agent
const agent = new Agent({
  name: 'my-agent',
  description: 'A simple agent',
  handler: async (ctx) => {
    return ctx.reply('Hello from WireAgent!');
  },
});

// Start the runtime
const runtime = new Runtime();
runtime.register(agent);
runtime.start();

Core Concepts

| Concept | Description | | ------------- | -------------------------------------------------------------- | | Agent | A unit of work with a defined purpose, tools, and behavior. | | Runtime | The execution environment that manages agent lifecycles. | | Wire | A connection between agents enabling message passing. | | Hook | Lifecycle callbacks (onCreate, onStart, onStop, onError, etc). | | Registry | A catalog of available agents and their configurations. |

Agent Lifecycle

define → register → start → running → stop → retire
                      ↑         |
                      └── restart ←┘

Each transition fires lifecycle hooks you can use to add logging, validation, health checks, or custom behavior.

Self-Hosting

WireAgent is designed to run anywhere you run Node.js:

• Docker — docker run wireagent/wireagent
• Kubernetes — Helm chart coming soon
• Bare metal — npx wireagent start
• Edge — Lightweight runtime for constrained environments

Project Status

WireAgent is in early development. The API is not yet stable. We welcome contributions and feedback.

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT