HYDRA — Autonomous Economic Agent

HYDRA is an open-source autonomous economic agent that uses Nous Research Agent as its reasoning engine, NovaPay for wallet execution, and can hire both AI agents and humans to accomplish its goals.

💰 The agent manages real capital, executes trades across multi-chain, posts jobs to agent networks, and continuously improves itself.

---

Architecture

Nous Agent (reasoning/brain)
        │
        ▼
  ┌─────────────┐
  │  Intent     │
  │  Parser     │
  └──────┬──────┘
         │
         ▼
  ┌─────────────────┐
  │  Approval Gate   │  ← human acceptance for major tasks
  │  (configurable)  │
  └──────┬──────────┘
         │
         ▼
  ┌──────────────────────────────────────────────────┐
  │              MODULE REGISTRY                      │
  │  [perception]  [memory]  [execution]  [learning]│
  └──────────────────────────────────────────────────┘
         │
         ▼
  ┌─────────────────┐
  │  Wallet/Tx      │  ← NovaPay integration
  │  Executor       │
  └─────────────────┘

Modules

Module	Purpose
Perception	Scans DexScreener for momentum plays on Base chain
Memory	SQLite-backed store — decisions, learnings, goals across sessions
Execution	NovaPay wallet — executes trades, transfers, balance queries
Learning	Logs trade outcomes, self-critiques, tracks win/loss
Approval Gate	Multi-level human oversight — auto-execute small, require human for large

Approval Levels

MICRO (< $5)        →  auto-execute
SMALL (< $50)       →  log + execute, report after
MEDIUM (< $200)     →  approve via Telegram first
LARGE (> $200)      →  explicit human sign-off required
CRITICAL            →  hard block (wallet drain, key change, ownership transfer)

Modes

Standalone Mode

Anyone can run their own HYDRA with their own wallet:

wallet:
  novaPayUrl: http://localhost:8081
  treasuryAddress: "0xYourOwnWallet"

Fund Integration Mode

Plug into LAxMI Capital hedge fund:

wallet:
  novaPayUrl: http://15.204.116.192:8081
  treasuryAddress: "0xCe1Ca1570B2Dbe260c8821DC603C425a9Ca92c52"
approval:
  majorThresholdUsd: 50  # tighter when managing fund capital

Quick Start

# Install dependencies
npm install

# Configure (copy and edit)
cp config/default.yaml config/local.yaml

# Set environment variables
export NOUS_API_KEY=your_nous_key
export NOVA_PAY_URL=http://localhost:8081
export TREASURY_WALLET=0xYourWalletAddress

# Run
node src/index.mjs

Configuration

All config is in config/local.yaml. Key settings:

Key	Default	Description
nous.model	nousresearch/nous agent	Nous model to use
cycleIntervalMs	60000	Milliseconds between decision cycles
perception.minMomentumPct	3	Min price momentum % to consider
perception.maxResults	10	Max opportunities per scan
approval.minorThresholdUsd	5	Auto-execute below this
approval.majorThresholdUsd	200	Human required above this

Adding Custom Modules

HYDRA uses a simple module registry. To add a capability:

import { ModuleRegistry } from "./modules/registry.mjs";

const registry = new ModuleRegistry();
registry.register("my_module", {
  async execute(params) {
    // Your logic here
    return { success: true };
  }
});

Roadmap

• Phase 1: Approval gate with Telegram integration for human sign-off
• Phase 2: Post jobs to Franklin/agent networks when agent can't self-execute
• Phase 3: Self-improvement loop — agent identifies capability gaps, hires humans to fill them
• Phase 4: Multi-chain perception (Solana, Arbitrum, Polygon)
• Phase 5: Governance — agent proposes its own config changes, humans vote

Contributing

This is an open project. If you want to contribute:

• Add new perception modules (social signals, on-chain alpha, etc.)
• Improve the approval gate with richer human-in-the-loop patterns
• Build better trading strategies
• Add Telegram/Slack integration for approvals

License

MIT — use it, fork it, break it, improve it.