ethagent 0.1.0 → 0.2.0

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.
Files changed (3) hide show
  1. package/README.md +33 -20
  2. package/package.json +9 -7
  3. package/src/cli.tsx +1 -1
package/README.md CHANGED
@@ -1,43 +1,56 @@
1
- <img src="preview/cli.png" alt="ethagent" width="600" />
1
+ <img src="https://bairon.dev/preview/cli.png" alt="ethagent" width="600" />
2
2
 
3
- A local-first AI agent with a permanent Ethereum identity. Runs entirely on your machine.
3
+
4
+ A privacy-first AI agent with a permanent Ethereum identity. Your knowledge base lives on IPFS. Your agent's identity is registered onchain, tied to your wallet. Your inference never leaves your machine.
4
5
 
5
6
  ```bash
6
7
  npm install -g ethagent
7
8
  ```
8
9
 
9
- ## Why
10
+ ## What It Is
10
11
 
11
- When you use cloud AI, every prompt you send, every codebase you share, every reasoning chain you build becomes training data. Your workflows, your thinking, your decision patterns. That data is worth far more than the $20/mo subscription you're paying. It trains the next generation of models, informs product roadmaps, and builds competitive moats for companies that don't share the upside with you.
12
+ ethagent bootstraps a local LLM on your machine and builds a personal knowledge base from sources you define. It works completely offline. No wifi, no API, just your hardware. The model is hotswappable, and if you need to, you can point it at a cloud model without losing any context. Offline-capable agents are going to be a core part of how software gets built, and ethagent is built for that from day one.
12
13
 
13
- ethagent runs inference entirely on your hardware. Your prompts never leave your machine. Your knowledge base is yours.
14
+ - Your Ethereum address owns and controls your agent
15
+ - Your knowledge base is pinned to IPFS, content-addressed and portable
16
+ - Your agent is registered onchain via [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004)
17
+ - Everything you teach it compounds across sessions, not just within them
14
18
 
19
+ Wipe your laptop, restore from your address or ENS name, and you're back exactly where you left off.
15
20
 
16
- ## Your agent
21
+ ```bash
22
+ npx ethagent init --from bairon.eth
23
+ npx ethagent init --from 0xA1E977e700bF82019beb381F1582575303A389CE
24
+ ```
17
25
 
18
- Think of it like a tamagotchi you raise on your own machine. You feed it knowledge. Every conversation you have, every document you give it, every correction you make compounds. ethagent builds a knowledge base that's specific to you, your domain, your way of thinking. It doesn't reset between sessions. It doesn't flatten your context into a generic system prompt. It accumulates.
26
+ ## Why It Exists
19
27
 
20
- Your inference runs on your hardware, your agent lives on your identity, and everything it learns stays with you. No usage limits. No rate caps. Just your machine, working for you.
28
+ AI platforms compete aggressively and users switch between them constantly. Every time you do, your conversation history, custom instructions, and everything your agent learned about you resets to zero. But every prompt you sent to the old platform is still there, training their next model.
21
29
 
30
+ ethagent breaks that cycle. Your knowledge lives on IPFS, your identity lives on Ethereum. Switch models whenever you want. Your agent remembers everything regardless. Your data stays yours, not by policy, but by architecture.
22
31
 
23
- ## How it works
32
+ ## How It Works
24
33
 
25
- ethagent bootstraps a local LLM on your machine and builds a knowledge base from sources you define. Your agent gets a permanent onchain identity using [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004), the token standard for registering autonomous agents on Ethereum. Identity is tied to an Ethereum address or ENS name, so it can be restored on any machine.
34
+ ethagent accumulates a personal knowledge base from conversations, documents, and corrections you provide. That knowledge base is pinned to IPFS, so it's content-addressed, verifiable, and not locked to any single device. The underlying model is hotswappable, so you can run a local LLM or swap in a cloud model without losing any context.
26
35
 
27
- All inference runs locally. Your data never leaves your hardware. The knowledge base is pinned to IPFS so it's portable and verifiable.
36
+ Your agent's identity is registered onchain using ERC-8004, the token standard for autonomous agents on Ethereum. Identity is tied to an Ethereum address or ENS name, meaning your agent can be fully restored on any machine from just your address.
28
37
 
38
+ Think of it like a tamagotchi that lives in your wallet. You raise it, you feed it knowledge, and only your key can summon it. Every interaction compounds. It doesn't flatten your context into a generic system prompt. It accumulates. And because it lives on IPFS, it follows you to any machine you bring your wallet to.
29
39
 
30
- ## Portability
40
+ | Layer | Where | What it does |
41
+ |-------|-------|--------------|
42
+ | Inference | Your machine (or cloud) | Hotswappable model, local-first by default |
43
+ | Knowledge | IPFS | Content-addressed, verifiable, portable across any machine |
44
+ | Identity | Ethereum | Permanent agent registration via ERC-8004, restorable from address or ENS |
31
45
 
32
- Your agent is tied to your Ethereum identity, not your machine. Knowledge lives on IPFS. Identity lives onchain. Wipe your laptop, restore from your address, and you're back exactly where you left off.
46
+ Your knowledge base is encrypted with your wallet's key. Only you can decrypt it. Even though the data lives on IPFS, it's unreadable to anyone without your key. Nobody can clone your agent, read its memories, or extract what it knows about you.
33
47
 
34
- ```bash
35
- npx ethagent init --from bairon.eth
36
- npx ethagent init --from 0xA1E977e700bF82019beb381F1582575303A389CE
37
- ```
48
+ ## Links
38
49
 
39
- As long as Ethereum exists, so does your agent.
50
+ - [npm package](https://www.npmjs.com/package/ethagent)
51
+ - [GitHub](https://github.com/baairon/ethagent)
52
+ - [ERC-8004 specification](https://eips.ethereum.org/EIPS/eip-8004)
40
53
 
41
- ---
54
+ ## License
42
55
 
43
- MIT License
56
+ MIT
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "ethagent",
3
- "version": "0.1.0",
4
- "description": "A local-first AI agent with an Ethereum identity",
3
+ "version": "0.2.0",
4
+ "description": "A privacy-first AI agent with an Ethereum identity",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "ethagent": "./bin/ethagent.js"
@@ -17,9 +17,13 @@
17
17
  "ethereum",
18
18
  "agent",
19
19
  "ai",
20
- "local-first",
20
+ "privacy-first",
21
+ "local-llm",
22
+ "ipfs",
21
23
  "ERC-8004",
22
- "onchain"
24
+ "onchain",
25
+ "offline",
26
+ "ens"
23
27
  ],
24
28
  "author": "bairon.eth",
25
29
  "license": "MIT",
@@ -28,7 +32,5 @@
28
32
  "react": "^19.2.4",
29
33
  "tsx": "^4.21.0"
30
34
  },
31
- "devDependencies": {
32
- "ansi-to-svg": "^1.4.3"
33
- }
35
+ "devDependencies": {}
34
36
  }
package/src/cli.tsx CHANGED
@@ -116,7 +116,7 @@ const App = () => {
116
116
  const tLines = T.split('\n')
117
117
 
118
118
  const w = 69
119
- const topLabel = ' local AI agent with a portable ethereum identity '
119
+ const topLabel = ' privacy-first AI agent with a portable ethereum identity '
120
120
 
121
121
  return (
122
122
  <Box flexDirection="column" alignSelf="flex-start" padding={1}>