agentnetes 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +98 -0
- package/dist/index.js +3 -2
- package/package.json +12 -3
package/README.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<img src="https://shashikant86.github.io/agentnetes/logo.png" alt="Agentnetes" width="80" height="80" />
|
|
4
|
+
|
|
5
|
+
# agentnetes
|
|
6
|
+
|
|
7
|
+
**Zero to a Self-Organizing AI Agency. On Demand.**
|
|
8
|
+
|
|
9
|
+
*Kubernetes for AI agents — type a goal, watch a swarm of specialist agents deliver.*
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/agentnetes)
|
|
12
|
+
[](https://www.npmjs.com/package/agentnetes)
|
|
13
|
+
[](https://github.com/Shashikant86/agentnetes/blob/main/LICENSE)
|
|
14
|
+
|
|
15
|
+
[Live Demo](https://shashikant86.github.io/agentnetes/) · [GitHub](https://github.com/Shashikant86/agentnetes)
|
|
16
|
+
|
|
17
|
+
</div>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## Quick start
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
# Get a free Google API key at aistudio.google.com, then:
|
|
25
|
+
GOOGLE_API_KEY=your_key npx agentnetes run "add comprehensive test coverage"
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
No install needed. Works on any git repository.
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## How it works
|
|
33
|
+
|
|
34
|
+
1. You type a goal inside any git repo
|
|
35
|
+
2. A root agent (Tech Lead) explores your codebase and invents a specialist team
|
|
36
|
+
3. Specialists run in parallel, each in their own isolated sandbox
|
|
37
|
+
4. They explore, write code, run tests, fix failures, and deliver together
|
|
38
|
+
5. A final synthesis summarises everything they found and built
|
|
39
|
+
|
|
40
|
+
Roles are fully emergent — nothing is hardcoded. A provider task spawns a Scout, Engineer, Tester, and Packager. A security audit spawns a completely different team.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Usage
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
# Run agents on the current git repo
|
|
48
|
+
GOOGLE_API_KEY=your_key npx agentnetes run "your goal here"
|
|
49
|
+
|
|
50
|
+
# Pre-warm a sandbox snapshot for faster runs (requires Vercel token)
|
|
51
|
+
npx agentnetes snapshot create
|
|
52
|
+
|
|
53
|
+
# List available snapshots
|
|
54
|
+
npx agentnetes snapshot list
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Environment variables
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
# Required — get a free key at aistudio.google.com
|
|
63
|
+
GOOGLE_API_KEY=
|
|
64
|
+
|
|
65
|
+
# Sandbox provider (default: docker)
|
|
66
|
+
SANDBOX_PROVIDER=docker # docker | local | vercel | e2b | daytona
|
|
67
|
+
|
|
68
|
+
# Optional — Vercel AI Gateway instead of direct Gemini
|
|
69
|
+
AI_GATEWAY_BASE_URL=
|
|
70
|
+
AI_GATEWAY_API_KEY=
|
|
71
|
+
|
|
72
|
+
# Optional — override default models
|
|
73
|
+
PLANNER_MODEL=google/gemini-2.5-pro
|
|
74
|
+
WORKER_MODEL=google/gemini-2.5-flash
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Sandbox providers
|
|
80
|
+
|
|
81
|
+
| Provider | Requirement | Notes |
|
|
82
|
+
|----------|-------------|-------|
|
|
83
|
+
| `docker` | Docker installed | Default. One container per agent. |
|
|
84
|
+
| `local` | Nothing | Clones repo to temp dir, runs on host. |
|
|
85
|
+
| `vercel` | `VERCEL_TOKEN` | Vercel Firecracker microVMs. |
|
|
86
|
+
| `e2b` | `E2B_API_KEY` | E2B cloud sandboxes. |
|
|
87
|
+
|
|
88
|
+
For the Docker provider, pull the base image once:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
docker pull node:20-alpine
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## License
|
|
97
|
+
|
|
98
|
+
MIT — [github.com/Shashikant86/agentnetes](https://github.com/Shashikant86/agentnetes)
|
package/dist/index.js
CHANGED
|
@@ -1008,8 +1008,9 @@ async function main() {
|
|
|
1008
1008
|
console.log(" agentnetes snapshot list List available snapshots");
|
|
1009
1009
|
console.log("");
|
|
1010
1010
|
console.log("Environment variables:");
|
|
1011
|
-
console.log("
|
|
1012
|
-
console.log("
|
|
1011
|
+
console.log(" GOOGLE_API_KEY Google Gemini API key (aistudio.google.com)");
|
|
1012
|
+
console.log(" SANDBOX_PROVIDER docker | local | vercel | e2b (default: docker)");
|
|
1013
|
+
console.log(" AI_GATEWAY_BASE_URL Vercel AI Gateway endpoint (optional)");
|
|
1013
1014
|
}
|
|
1014
1015
|
}
|
|
1015
1016
|
main().catch((err) => {
|
package/package.json
CHANGED
|
@@ -1,8 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentnetes",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Zero to a self-organizing AI agency. On demand.",
|
|
5
|
-
"keywords": [
|
|
5
|
+
"keywords": [
|
|
6
|
+
"ai",
|
|
7
|
+
"agents",
|
|
8
|
+
"cli",
|
|
9
|
+
"gemini",
|
|
10
|
+
"vercel",
|
|
11
|
+
"autonomous"
|
|
12
|
+
],
|
|
6
13
|
"license": "MIT",
|
|
7
14
|
"repository": {
|
|
8
15
|
"type": "git",
|
|
@@ -12,7 +19,9 @@
|
|
|
12
19
|
"bin": {
|
|
13
20
|
"agentnetes": "./dist/index.js"
|
|
14
21
|
},
|
|
15
|
-
"files": [
|
|
22
|
+
"files": [
|
|
23
|
+
"dist"
|
|
24
|
+
],
|
|
16
25
|
"scripts": {
|
|
17
26
|
"build": "tsup",
|
|
18
27
|
"dev": "tsx src/index.ts",
|