Lucid Agents

The Protocol-Agnostic Multi-Runtime Framework for Building and Monetizing AI Agents

Build, deploy, and monetize autonomous AI agents with typed entrypoints, onchain identity, and built-in payment infrastructure.

______________________________________________________________________

什么是Lucid特工？

Lucid Agents是一个基于TypeScript的框架，用于构建和货币化AI代理。代理商务和支付SDK。构建AI代理，销售服务，促进货币交易，并参与代理对代理市场。

核心能力：

行业标准协议：原生支持x402（支付）、A2A（代理到代理通信）和ERC-8004（链上身份）。构建与生态系统协同工作的代理
双向支付跟踪：使用持久存储跟踪传出付款（代理付款）和传入付款（代理接收）。具有策略执行功能的自动记录
付款政策：使用每笔付款限制、时间窗口总计、每个目标/每个发件人限制和允许/阻止列表来控制支出和应收账款。多个策略组，实现灵活控制
接受付款：使用自动支付墙中间件在以太坊L2（Base）或Solana上接受美元支付。无需支付基础设施代码
支付分析：全面的付款报告，包括汇总统计、交易历史和CSV/JSON导出，用于会计系统集成
代理间通信：代理可以发现和调用其他代理，实现代理市场和多代理系统，代理可以在这些市场和系统中相互买卖服务
链上身份：在链上注册代理身份，建立声誉，并证明对代理市场信任的所有权
框架灵活性：编写一次代理逻辑，部署在Hono、TanStack Start、Express或Next.js上。选择适合您堆栈的框架
类型安全API：使用Zod模式定义输入/输出，获得自动验证、JSON模式和完整的TypeScript推理
实时流媒体：流式代理响应的服务器发送事件（SSE）。非常适合LLM输出和长时间运行的操作
任务管理：通过SSE订阅进行状态跟踪、取消和实时更新的长期运行任务
自动发现：自动生成的带有Open Graph标签的AgentCard清单。代理可以在目录中发现，并在共享时显示丰富的预览
快速开始：带有常见模式模板的CLI脚手架。在几分钟内找到一个工作代理，而不是几个小时
多网络支持：接受EVM（Base、Ethereum、Sepolia）或Solana（mainnet、devnet）网络上的付款
可组合架构：只添加您需要的功能。支付、身份、A2A、钱包、分析。随着你的经纪人的发展，混合搭配

无论您是在构建付费人工智能服务、代理市场，还是代理相互交易的多代理系统，Lucid agents都能提供您所需的支付和商务基础设施。

______________________________________________________________________

快速入门（5分钟）

让你的第一个货币化的人工智能代理在几分钟内运行。

先决条件

包子 >=1.0（推荐）或Node.js>=20.9
来自首选LLM提供商（OpenAI、Anthropic等）的API密钥
可选：用于接收付款的钱包地址

1.创建和配置您的代理

# Interactive mode - CLI guides you through all options
bunx @lucid-agents/cli my-agent

# Or use inline configuration for faster setup
bunx @lucid-agents/cli my-agent \
  --adapter=hono \
  --template=identity \
  --AGENT_NAME="My AI Agent" \
  --AGENT_DESCRIPTION="AI-powered assistant" \
  --PAYMENTS_RECEIVABLE_ADDRESS=0xYourAddress \
  --NETWORK=ethereum \
  --DEFAULT_PRICE=1000

CLI将：

选择适配器: hono （HTTP服务器）， tanstack-ui （全仪表板）， tanstack-headless （仅限API）， express （Node.js服务器），或 next （Next.js应用路由器）
模板选择: blank （最小）， identity （链上身份）， trading-data-agent （商人），或 trading-recommendation-agent （购物者）
配置：设置代理元数据、LLM密钥和可选付款详细信息
安装依赖项：自动运行 bun install

2.启动您的代理

cd my-agent
bun run dev

您的代理现在正在运行 http://localhost:3000!

试试看：

# View agent manifest
curl http://localhost:3000/.well-known/agent.json

# List entrypoints
curl http://localhost:3000/entrypoints

# Invoke an entrypoint (example for echo template)
curl -X POST http://localhost:3000/entrypoints/echo/invoke \
  -H "Content-Type: application/json" \
  -d '{"input": {"text": "Hello, Lucid Agents!"}}'

______________________________________________________________________

架构概述

Lucid Agents是一个TypeScript单仓库，用于协议无关的多运行时代理部署，具有组合扩展架构：

第1层：核心 -具有扩展系统的协议无关代理运行时(@lucid-agents/core)-无协议特定代码
第2层：扩展 -通过组合添加的可选功能： http() （HTTP协议）， payments() （x402）， wallets() （钱包管理）， identity() （ERC-8004）， a2a() （代理人对代理人）， ap2() （代理支付协议）
第3层：适配器 -使用HTTP扩展的框架集成（hono、tanstack、express、next）

核心运行时完全与协议无关。HTTP等协议作为扩展提供，并合并到运行时中。未来的协议（gRPC、WebSocket等）可以作为附加扩展添加。

有关包括依赖关系图、请求流和扩展系统设计在内的详细架构文档，请参阅 docs/ARCHITECTURE.md.

包裹

@lucid-agents/types -所有包中使用的共享类型定义
@lucid-agents/core -具有扩展系统的协议无关代理运行时
@lucid-agents/http -用于请求/响应处理、流式传输和SSE的HTTP扩展
@lucid-agents/wallet -用于代理和开发者钱包管理的钱包SDK
@lucid-agents/payments -x402支付工具，具有双向跟踪、支付策略和持久存储（SQLite、内存、Postgres）
@lucid-agents/analytics -通过CSV/JSON导出进行支付分析和报告，以实现会计系统集成
@lucid-agents/identity -ERC-8004链上代理身份识别工具包
@lucid-agents/a2a -A2A用于代理间通信的协议客户端
@lucid-agents/ap2 -AP2（代理支付协议）代理卡扩展
@lucid-agents/hono -Hono HTTP服务器适配器
@lucid-agents/express -Express HTTP服务器适配器
@lucid-agents/tanstack -TanStack启动适配器（UI和无头变体）
@lucid-agents/cli -用于创建新代理项目的CLI脚手架工具

关键概念

入口点：定义代理功能的类型化API终结点。每个入口点都有：

输入/输出模式（Zod）
可选价格（x402）
处理程序（同步）或流处理程序（SSE）

适配器：将入口点作为HTTP路由公开的运行时框架。根据您的部署需求进行选择：

hono -轻量级、边缘兼容的HTTP服务器
tanstack -全套React with UI dashboard（或仅限无头API）
express -传统的Node.js HTTP服务器
next -Next.js应用路由器集成

A2A通信：代理间通信协议，使代理能够调用其他代理：

直接调用：通过同步呼叫 client.invoke() 或 client.stream()
基于任务的操作：长时间运行的任务 sendMessage()、状态跟踪和取消
多回合对话：将相关任务分组 contextId 用于会话代理
药剂组成：代理既可以充当客户端，也可以充当服务器，从而实现复杂的供应链

清单：自动生成的代理卡(.well-known/agent-card.json)它描述了您的代理的功能、定价以及发现工具和A2A协议的身份。使用不可变组合模式构建。

支付网络：接受以下付款：

以太坊虚拟机：Base、以太坊、Sepolia（ERC-20美元）
索拉纳：主网、发展网（SPL USDC）

身份：ERC-8004用于声誉和信任的链上身份。注册一次，在所有网络中引用。

付款政策：通过限制、时间窗口和允许/阻止列表控制传出和传入付款。将策略组织成组，以便灵活控制。

支付分析：使用汇总统计数据、交易历史记录跟踪支出和收入，并导出到CSV/JSON用于会计系统。

______________________________________________________________________

关键包

核心包

`@lucid-agents/core`

具有扩展系统的协议无关代理运行时。

import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';
import { z } from 'zod';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
  description: 'My first agent',
})
  .use(http())
  .build();

agent.entrypoints.add({
  key: 'greet',
  input: z.object({ name: z.string() }),
  async handler({ input }) {
    return { output: { message: `Hello, ${input.name}!` } };
  },
});

`@lucid-agents/hono`

用于构建传统HTTP服务器的Hono适配器。

import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';
import { createAgentApp } from '@lucid-agents/hono';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(http())
  .build();

const { app, addEntrypoint } = await createAgentApp(agent);

// Add entrypoints...

// Export for Bun.serve or use Hono serve helper
export default {
  port: Number(process.env.PORT ?? 3000),
  fetch: app.fetch,
};

`@lucid-agents/tanstack`

带有UI和无头变体的TanStack Start适配器。

import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';
import { createTanStackRuntime } from '@lucid-agents/tanstack';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(http())
  .build();

export const { runtime: tanStackRuntime, handlers } =
  await createTanStackRuntime(agent);

`@lucid-agents/http`

用于请求/响应处理、流式传输和服务器发送事件的HTTP扩展。

import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(http({ landingPage: true }))
  .build();

// Access HTTP handlers via agent.handlers

`@lucid-agents/identity`

用于链上身份、信誉和验证的ERC-8004工具包。

import { createAgent } from '@lucid-agents/core';
import { wallets } from '@lucid-agents/wallet';
import { walletsFromEnv } from '@lucid-agents/wallet';
import { createAgentIdentity } from '@lucid-agents/identity';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(wallets({ config: walletsFromEnv() }))
  .build();

const identity = await createAgentIdentity({
  runtime: agent,
  domain: 'my-agent.example.com',
  autoRegister: true, // Register onchain if not exists
});

`@lucid-agents/payments`

x402支付工具，具有双向跟踪、支付策略和持久存储功能。

import { createAgent } from '@lucid-agents/core';
import { payments } from '@lucid-agents/payments';
import { paymentsFromEnv } from '@lucid-agents/payments';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(
    payments({
      config: {
        ...paymentsFromEnv(),
        policyGroups: [
          {
            name: 'Daily Limits',
            outgoingLimits: {
              global: { maxTotalUsd: 100.0, windowMs: 86400000 },
            },
            incomingLimits: {
              global: { maxTotalUsd: 5000.0, windowMs: 86400000 },
            },
            blockedSenders: {
              domains: ['https://untrusted.example.com'],
            },
          },
        ],
      },
      storage: { type: 'sqlite' }, // or 'in-memory' or 'postgres'
    })
  )
  .build();

// Auto-detects EVM vs Solana from PAYMENTS_RECEIVABLE_ADDRESS format
// Automatically tracks outgoing and incoming payments

`@lucid-agents/a2a`

A2A用于代理到代理通信的协议客户端。

import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';
import { a2a } from '@lucid-agents/a2a';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(http())
  .use(a2a())
  .build();

// Access A2A client via agent.a2a
const result = await agent.a2a.client.invoke(
  'https://other-agent.com',
  'skillId',
  {
    input: 'data',
  }
);

`@lucid-agents/analytics`

用于会计系统的CSV/JSON导出支付分析和报告。

import { createAgent } from '@lucid-agents/core';
import { analytics } from '@lucid-agents/analytics';
import { getSummary, exportToCSV } from '@lucid-agents/analytics';
import { payments, paymentsFromEnv } from '@lucid-agents/payments';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(payments({ config: paymentsFromEnv() }))
  .use(analytics())
  .build();

// Get payment summary
const summary = await getSummary(agent.analytics.paymentTracker, 86400000);
console.log(
  `Outgoing: ${summary.outgoingTotal}, Incoming: ${summary.incomingTotal}`
);

// Export to CSV for accounting systems
const csv = await exportToCSV(agent.analytics.paymentTracker);

`@lucid-agents/ap2`

AP2（代理支付协议）代理卡扩展。

import { createAgent } from '@lucid-agents/core';
import { ap2 } from '@lucid-agents/ap2';

const agent = await createAgent({
  name: 'my-agent',
  version: '1.0.0',
})
  .use(ap2({ roles: ['merchant'] }))
  .build();

`@lucid-agents/wallet`

用于代理和开发人员钱包管理的钱包SDK。

import { createAgentWallet } from '@lucid-agents/wallet';

const wallet = await createAgentWallet({
  type: 'local',
  privateKey: process.env.AGENT_WALLET_PRIVATE_KEY,
});

// Or use a thirdweb Engine wallet with the same connector interface
const agent = await createAgent({
  name: 'thirdweb-agent',
  version: '0.1.0',
})
  .use(http())
  .use(
    wallets({
      config: {
        agent: {
          type: 'thirdweb',
          secretKey: process.env.AGENT_WALLET_SECRET_KEY!,
          clientId: process.env.AGENT_WALLET_CLIENT_ID,
          walletLabel: 'agent-wallet',
          chainId: 84532, // Base Sepolia
        },
      },
    })
  )
  .build();

const connector = agent.wallets?.agent?.connector;
const capabilities = connector?.getCapabilities?.();
if (!connector?.getWalletClient || !capabilities?.walletClient) {
  throw new Error('thirdweb wallet client not available');
}

const walletClient = (await connector.getWalletClient())?.client;
if (!walletClient) {
  throw new Error('Wallet client not initialized');
}

await walletClient.writeContract({
  account: walletClient.account,
  chain: walletClient.chain,
  address: USDC_ADDRESS,
  abi: erc20Abi,
  functionName: 'transfer',
  args: ['0xEA4b0D5ebF46C22e4c7E6b6164706447e67B9B1D', 10_000n], // 0.01 USDC
});

CLI工具

`@lucid-agents/cli`

CLI，用于使用模板和交互式配置构建新的代理项目。

# Interactive mode
bunx @lucid-agents/cli

# With options
bunx @lucid-agents/cli my-agent \
  --adapter=tanstack-ui \
  --template=identity \
  --non-interactive

每个包都包含详细的API文档、环境变量引用和工作示例。

______________________________________________________________________

示例：全功能代理

以下是一个完整的示例，显示了身份、支付和LLM与流媒体的集成：

import { z } from 'zod';
import { createAgent } from '@lucid-agents/core';
import { http } from '@lucid-agents/http';
import { wallets } from '@lucid-agents/wallet';
import { walletsFromEnv } from '@lucid-agents/wallet';
import { payments } from '@lucid-agents/payments';
import { paymentsFromEnv } from '@lucid-agents/payments';
import { identity, identityFromEnv } from '@lucid-agents/identity';
import { createAgentApp } from '@lucid-agents/hono';

// Build app with all extensions (identity extension handles ERC-8004 registration automatically)
const agent = await createAgent({
  name: 'ai-assistant',
  version: '1.0.0',
  description: 'AI assistant with onchain identity and streaming responses',
  image: 'https://my-agent.example.com/og-image.png',
})
  .use(http())
  .use(wallets({ config: walletsFromEnv() }))
  .use(payments({ config: paymentsFromEnv() }))
  .use(identity({ config: identityFromEnv() }))
  .build();

const { app, addEntrypoint } = await createAgentApp(agent);

// 4. Add paid entrypoint with streaming
addEntrypoint({
  key: 'chat',
  description: 'Chat with AI assistant',
  input: z.object({
    message: z.string(),
    history: z
      .array(
        z.object({
          role: z.enum(['user', 'assistant']),
          content: z.string(),
        })
      )
      .optional(),
  }),
  streaming: true,
  async stream(ctx, emit) {
    const messages = [
      ...(ctx.input.history || []),
      { role: 'user' as const, content: ctx.input.message },
    ];

    const stream = await ai.chat.stream({ messages });

    for await (const chunk of stream) {
      await emit({
        kind: 'delta',
        delta: chunk.delta,
        mime: 'text/plain',
      });
    }

    return {
      output: { completed: true },
      usage: { total_tokens: stream.usage.total_tokens },
    };
  },
});

// Export for Bun.serve or use Hono serve helper
const port = Number(process.env.PORT ?? 3000);
export default {
  port,
  fetch: app.fetch,
};

演示的功能：

链上身份注册（ERC-8004）。由身份扩展自动处理
自动x402付款验证
具有政策执行的双向支付跟踪
通过SSE流式传输LLM响应
类型安全的输入/输出模式
信任清单中可验证代理身份的元数据
打开Graph标签进行查找

______________________________________________________________________

发展

设置

# Clone the repository
git clone https://github.com/daydreamsai/lucid-agents.git
cd lucid-agents

# Install dependencies
bun install

# Build all packages
bun run build:packages

包装开发

# Work on a specific package
cd packages/core

# Build this package
bun run build

# Run tests
bun test

# Type check
bun run type-check

# Lint and format
bun run lint:fix
bun run format

______________________________________________________________________

贡献

我们欢迎捐款！无论您是在修复错误、添加功能还是改进文档。

开发设置

分叉和克隆 存储库

安装依赖项：

   bun install

构建所有包 （必填-必须按依赖顺序运行）：

   bun run build:packages

进行更改：

- 为新功能添加测试 - 根据需要更新文档

提交前运行检查：

   bun test              # All tests
   bun run type-check    # TypeScript validation
   bun run lint          # Code linting

创建变更集：

   bun run changeset

提交拉取请求

有关详细指南，请参阅贡献.md.

______________________________________________________________________

资源

文档

架构指南: docs/ARCHITECTURE.md -系统设计、依赖关系图和请求流
软件包自述文件：每个包都有全面的文件和 AGENTS.md 文件
贡献指南: 贡献.md -开发工作流程和指南

协议和规范

ERC-8004规范: EIP-8004 -链上代理身份标准
x402协议: -HTTP原生支付协议
A2A协议: 代理间通信 -代理发现和通信协议

技术

Hono框架: hono.dev -轻量级web框架
TanStack启动: tanstack.com/start -全栈React框架
Bun运行时: bun.sh -快速JavaScript运行时
萨德: zod.dev -TypeScript第一模式验证

______________________________________________________________________

许可证

该项目根据 MIT许可证。请参阅许可证文件以获取详细信息。

______________________________________________________________________

贡献者

______________________________________________________________________

星史

______________________________________________________________________

Built with ❤️ by the Daydreams AI team

GitHub • npm • Twitter

Lucid Agents

快速接入

详细介绍

什么是Lucid特工？

快速入门（5分钟）

先决条件

1.创建和配置您的代理

2.启动您的代理

架构概述

包裹

关键概念

关键包

核心包

CLI工具

示例：全功能代理

发展

设置

包装开发

贡献

开发设置

资源

文档

协议和规范

技术

许可证

贡献者

星史

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP