ethagent 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+<img src="preview/cli.png" alt="ethagent" width="600" />
+
+A local-first AI agent with a permanent Ethereum identity. Runs entirely on your machine.
+
+```bash
+npm install -g ethagent
+```
+
+## Why
+
+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.
+
+ethagent runs inference entirely on your hardware. Your prompts never leave your machine. Your knowledge base is yours.
+
+
+## Your agent
+
+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.
+
+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.
+
+
+## How it works
+
+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.
+
+All inference runs locally. Your data never leaves your hardware. The knowledge base is pinned to IPFS so it's portable and verifiable.
+
+
+## Portability
+
+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.
+
+```bash
+npx ethagent init --from bairon.eth
+npx ethagent init --from 0xA1E977e700bF82019beb381F1582575303A389CE
+```
+
+As long as Ethereum exists, so does your agent.
+
+---
+
+MIT License

package/bin/ethagent.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { execFileSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const cli = join(__dirname, '..', 'src', 'cli.tsx')
+
+execFileSync('node', ['--import', 'tsx/esm', cli], { stdio: 'inherit' })

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ethagent",
+  "version": "0.1.0",
+  "description": "A local-first AI agent with an Ethereum identity",
+  "type": "module",
+  "bin": {
+    "ethagent": "./bin/ethagent.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "start": "node bin/ethagent.js"
+  },
+  "keywords": [
+    "ethereum",
+    "agent",
+    "ai",
+    "local-first",
+    "ERC-8004",
+    "onchain"
+  ],
+  "author": "bairon.eth",
+  "license": "MIT",
+  "dependencies": {
+    "ink": "^6.8.0",
+    "react": "^19.2.4",
+    "tsx": "^4.21.0"
+  },
+  "devDependencies": {
+    "ansi-to-svg": "^1.4.3"
+  }
+}

package/src/cli.tsx

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import React from 'react'
+import {render, Text, Box} from 'ink'
+
+const eth = `░░░░░░░╗░░░░░░░░╗░░╗  ░░╗
+░░╔════╝╚══░░╔══╝░░║  ░░║
+░░░░░╗     ░░║   ░░░░░░░║
+░░╔══╝     ░░║   ░░╔══░░║
+░░░░░░░╗   ░░║   ░░║  ░░║
+╚══════╝   ╚═╝   ╚═╝  ╚═╝`
+
+const A = [
+  ` █████╗ `,
+  `██╔══██╗`,
+  `███████║`,
+  `██╔══██║`,
+  `██║  ██║`,
+  `╚═╝  ╚═╝`,
+].join('\n')
+
+const G = [
+  ` ██████╗ `,
+  `██╔════╝ `,
+  `██║  ███╗`,
+  `██║   ██║`,
+  `╚██████╔╝`,
+  ` ╚═════╝ `,
+].join('\n')
+
+const E = [
+  `███████╗`,
+  `██╔════╝`,
+  `█████╗  `,
+  `██╔══╝  `,
+  `███████╗`,
+  `╚══════╝`,
+].join('\n')
+
+const N = [
+  `███╗   ██╗`,
+  `████╗  ██║`,
+  `██╔██╗ ██║`,
+  `██║╚██╗██║`,
+  `██║ ╚████║`,
+  `╚═╝  ╚═══╝`,
+].join('\n')
+
+const T = [
+  `████████╗`,
+  `╚══██╔══╝`,
+  `   ██║   `,
+  `   ██║   `,
+  `   ██║   `,
+  `   ╚═╝   `,
+].join('\n')
+
+const eyes = `
+                                         -+:
+                   :=-                    -%@@@%.
+             *@@@@@#-                           *@@-
+          +@@.                                     +@
+        @@=                               -#=-+++=+:
+      #%        .:===-:                   -@* +@@@@%
+           *@-+@@@@@:                    %@@+  @@@=#@
+          *@=   @@@@@@@-                .@.@@@@@@@ :
+        @@+=@@@@@@@@@@@@:               .% *@@@@@*-=
+       #:-@ -@@@@@@@@@-+%                @  -@@@- #
+       :  #+  @@@@@@@- -%                 =#     =
+           -@:        *@                      .+%%
+              :%#: --
+              .-:
+                                                           `
+
+const palette = [
+  [0xe8, 0xa0, 0xa0],
+  [0xe8, 0xbe, 0x8f],
+  [0xe8, 0xdf, 0x9a],
+  [0x96, 0xd4, 0xa8],
+  [0x90, 0xb8, 0xe8],
+]
+
+function gradientColor(t) {
+  const s = Math.max(0, Math.min(1, t)) * (palette.length - 1)
+  const i = Math.min(Math.floor(s), palette.length - 2)
+  const f = s - i
+  const [r1, g1, b1] = palette[i]
+  const [r2, g2, b2] = palette[i + 1]
+  const r = Math.round(r1 + (r2 - r1) * f)
+  const g = Math.round(g1 + (g2 - g1) * f)
+  const b = Math.round(b1 + (b2 - b1) * f)
+  return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`
+}
+
+const Eyes = () => {
+  const lines = eyes.split('\n')
+  const maxLen = Math.max(...lines.map(l => l.trimEnd().length))
+  return (
+    <Box flexDirection="column">
+      {lines.map((line, li) => (
+        <Text key={li}>
+          {line.split('').map((char, ci) => (
+            <Text key={ci} color={gradientColor(ci / Math.max(maxLen - 1, 1))}>{char}</Text>
+          ))}
+        </Text>
+      ))}
+    </Box>
+  )
+}
+
+const App = () => {
+  const ethLines = eth.split('\n')
+  const aLines = A.split('\n')
+  const gLines = G.split('\n')
+  const eLines = E.split('\n')
+  const nLines = N.split('\n')
+  const tLines = T.split('\n')
+
+  const w = 69
+  const topLabel = ' local AI agent with a portable ethereum identity '
+
+  return (
+    <Box flexDirection="column" alignSelf="flex-start" padding={1}>
+      <Eyes />
+      <Text>
+        <Text color="#555555">╔═</Text>
+        <Text color="#777777">{topLabel}</Text>
+        <Text color="#555555">{'═'.repeat(w - topLabel.length - 1)}╗</Text>
+      </Text>
+      {ethLines.map((line, i) => (
+        <Box key={i}>
+          <Text color="#555555">║</Text>
+          <Text color="#555555">{ethLines[i]}</Text>
+          <Text color="#555555">{aLines[i]}</Text>
+          <Text color="#555555">{gLines[i]}</Text>
+          <Text color="#555555">{eLines[i]}</Text>
+          <Text color="#555555">{nLines[i]}</Text>
+          <Text color="#555555">{tLines[i]}</Text>
+          <Text color="#555555">║</Text>
+        </Box>
+      ))}
+      <Text color="#555555">{'╚' + '═'.repeat(w) + '╝'}</Text>
+      <Text color="#777777">{'\n coming soon...\n'}</Text>
+    </Box>
+  )
+}
+
+render(<App />)