🐝 Eremos

A modular framework for deploying autonomous swarm agents that monitor on-chain activity across the Solana ecosystem.
Built as a public good, open-source and extendable.

📑 Table of Contents

1. Quick Start
2. Features
3. Architecture
4. Example Signal
5. Meet Theron Agent 000
6. Signal Confidence
7. Tech Stack
8. Key Folders
9. Contributing
10. License
11. Links

---

Quick Start

Clone your fork
git clone https://github.com/YOUR-USERNAME/Eremos.git
cd Eremos

Install dependencies
npm install

Copy env file
cp .env.example .env.local

Start dev mode
npm run dev

---

Features

• Modular Agents - Scoped logic for detecting wallet activity, contract spawns, and anomalies
• Signal Emission - Structured signals for logging, alerting, or downstream use
• Swarm Design - Each agent operates independently with shared utilities
• Extensible Core - Plug in watchers, inference layers, or custom triggers
• Minimal Output - Log only what matters
• Launch Wallet Detection - Agents can trace freshly funded wallets (e.g. from CEXs), track their contract interactions, and flag high-confidence deploys in real time
• Ghost Watcher - Monitors long-dormant wallets that suddenly become active again. Useful for tracing old dev wallets or rug setups.
• + More to come.

---

Architecture

Eremos swarm agents follow a simple lifecycle:

• Observe — watch Solana programs, wallets, and flows
• Detect — flag bundling behavior, deploys, funding anomalies
• Signal — emit structured alerts and insights

---

Example Signal

An example signal emitted by an agent detecting a live token deployment:

[agent-observer] → fresh funding detected from kraken (wallet: 6Yxk...P2M8) at 04:41:12Z
[agent-observer] → contract probing detected within 4s (pump.fun interaction traced)
[agent-observer] → token created at 04:41:17Z (tx: 5gW...pump)
[agent-observer] → 5 bundle-linked wallets interacted within 8s of deploy
[agent-observer] → launch confidence spike (0.91) - emitting signal (elapsed: 13s)

{
  agent: "Observer",
  type: "launch_detected",
  glyph: "Δ",
  hash: "sig_c7f9a3d2bc",
  timestamp: "2025-06-12T04:41:25Z",
  source: "agent-observer",
  confidence: 0.91
}

---

Meet Theron Agent 000

Theron - Agent (000)

The first deployed agent in the swarm. Passive. Pattern-sensitive.
Modular and extendable by design.

Agent-001 Coming Soon Teaser

---

Signal Confidence

Each emitted signal includes a confidence score (0-1) based on behavioral heuristics:

• CEX-origin funding (e.g. Kraken, Coinbase)
• Time between funding → deploy
• Wallet linkage density (bundled activity)
• Token metadata validation

Confidence is computed via agent-side scoring and logged alongside the signal.

---

Tech Stack

• Frontend: Next.js, Tailwind CSS
• Backend: Node.js (TypeScript-based agent runner)
• Language: TypeScript (typed logic across agents, utils, and infra)
• Chain Layer: RPC watchers, mempool filters, native triggers

---

Key Folders

• /agents - Agent templates + logic
• /utils - Shared signal/logging utilities
• /types - TypeScript interfaces + definitions
• /scripts - Bootstrap and dev scripts
• /docs - Swarm structure, architecture, & our artwork/official whitepaper

---

Contributing

We welcome small, thoughtful contributions! See CONTRIBUTING.md for full guidelines.

---

License

MIT © Eremos LLC

---

Links

• Twitter/X: @EremosCore
• Website: Eremos.io
• Whitepaper: v1.0 PDF

Maintained by the Eremos Core team 💛.