|
11 | 11 | [](https://discord.gg/aJmE8wmQDS) |
12 | 12 |
|
13 | 13 | **A persistent AI agent framework for Cloudflare Workers.** |
| 14 | +**Published as `@stackbilt/aegis-core` — use standalone or extend as a dependency.** |
14 | 15 |
|
15 | 16 | Cognitive kernel with multi-tier memory, autonomous goal pursuit, a dreaming cycle, runtime tool creation, and 26 scheduled tasks. Deploy your own persistent AI co-founder on the edge. |
16 | 17 |
|
17 | 18 | ## What is AEGIS? |
18 | 19 |
|
19 | 20 | AEGIS is a framework for building **personal AI agents** that remember everything, pursue goals autonomously, create their own tools, and improve themselves while you sleep. Unlike chat-based AI tools that forget between sessions, AEGIS maintains persistent identity, memory, and state across every interaction. |
20 | 21 |
|
| 22 | +**Two ways to use AEGIS:** |
| 23 | +- **Standalone** — Clone, configure, deploy. Full agent in minutes. |
| 24 | +- **As a dependency** — `npm install @stackbilt/aegis-core` and extend with your own routes, scheduled tasks, executors, and MCP tools via `createAegisApp()`. |
| 25 | + |
21 | 26 | The production instance runs 26 scheduled tasks, has executed 236+ autonomous coding sessions, and costs $0/month to host (Cloudflare Workers free tier + Workers AI for inference). |
22 | 27 |
|
23 | 28 | Built on Cloudflare Workers for edge-native deployment. Zero cold starts. Global distribution. Pay-per-request economics. |
@@ -62,6 +67,36 @@ npx wrangler deploy |
62 | 67 |
|
63 | 68 | Visit `https://your-worker.workers.dev` and authenticate with your AEGIS_TOKEN. |
64 | 69 |
|
| 70 | +## Use as a Dependency |
| 71 | + |
| 72 | +Install `@stackbilt/aegis-core` and compose your own agent: |
| 73 | + |
| 74 | +```bash |
| 75 | +npm install @stackbilt/aegis-core |
| 76 | +``` |
| 77 | + |
| 78 | +```ts |
| 79 | +import { createAegisApp } from '@stackbilt/aegis-core'; |
| 80 | + |
| 81 | +const aegis = createAegisApp({ |
| 82 | + operator: myConfig, |
| 83 | + routes: [{ prefix: '/', router: myRoutes }], |
| 84 | + scheduledTasks: [myCustomTask], |
| 85 | +}); |
| 86 | + |
| 87 | +export default { |
| 88 | + fetch: aegis.app.fetch, |
| 89 | + scheduled: (e, env, ctx) => ctx.waitUntil(aegis.runScheduled(buildEdgeEnv(env))), |
| 90 | +}; |
| 91 | +``` |
| 92 | + |
| 93 | +Core provides: kernel, memory, dispatch, base routes, MCP server, scheduled task framework. |
| 94 | +You provide: operator config, custom routes, integrations, secrets. |
| 95 | + |
| 96 | +Extension interfaces: `ScheduledTaskPlugin`, `ExecutorPlugin`, `RoutePlugin`, `McpToolPlugin`. |
| 97 | + |
| 98 | +See [CONTRIBUTING.md](CONTRIBUTING.md#using-as-a-dependency) for full documentation. |
| 99 | + |
65 | 100 | ## Architecture |
66 | 101 |
|
67 | 102 | ``` |
|
0 commit comments