Snak（alpha版）

项目简介

一个用于创建能够与Starknet区块链交互的AI代理工具包。以NPM包形式提供，并附带一个预构建好的NestJS服务器及Web界面。支持包括Anthropic、OpenAI、Google Gemini和Ollama在内的多种AI提供商。

快速开始

先决条件

• Starknet钱包（推荐：Argent X）
• AI服务提供商API密钥
• Node.js及pnpm已安装

安装

git clone https://github.com/kasarlabs/snak.git
cd snak
pnpm install

配置

1. 创建.env文件：

# Starknet配置（必填）
STARKNET_PUBLIC_ADDRESS="你的Starknet公共地址"
STARKNET_PRIVATE_KEY="你的Starknet私钥"
STARKNET_RPC_URL="你的Starknet RPC URL"

# AI提供商配置（必填）
AI_PROVIDER_API_KEY="你的AI提供商API密钥"
AI_MODEL="你使用的AI模型"
AI_PROVIDER="你选择的AI提供商"

# NestJS服务器配置
SERVER_API_KEY="你的服务器API密钥"
SERVER_PORT="你的服务器端口"

# Node环境配置（可选，默认为development）
NODE_ENV="development"
PORT=3000

2. 创建agent.config.ts文件：

export default defineConfig({
  provider: {
    type: 'rpc',
    nodeUrl: process.env.STARKNET_RPC_URL,
  },
  accountPrivateKey: process.env.STARKNET_PRIVATE_KEY,
  accountPublicKey: process.env.STARKNET_PUBLIC_ADDRESS,
  aiModel: process.env.AI_MODEL,
  aiProvider: process.env.AI_PROVIDER,
  aiProviderApiKey: process.env.AI_PROVIDER_API_KEY,
});

使用说明

模式概览

在项目中集成Snak

1. 安装Snak包：

# 使用npm
npm install @snakagent

# 或使用pnpm
pnpm add @snakagent

2. 创建AI代理实例：

import { StarknetAgent } from 'starknet-agent-kit';

const agent = new StarknetAgent({
  provider: new RpcProvider({ nodeUrl: process.env.STARKNET_RPC_URL }),
  accountPrivateKey: process.env.STARKNET_PRIVATE_KEY,
  accountPublicKey: process.env.STARKNET_PUBLIC_ADDRESS,
  aiModel: process.env.AI_MODEL,
  aiProvider: process.env.AI_PROVIDER,
  aiProviderApiKey: process.env.AI_PROVIDER_API_KEY,
  signature: 'key',
  agentMode: 'auto',
});

const response = await agent.execute("What's my ETH balance?");

文档

更多详细信息请参考docs.kasar.io

对于更详细的文档，请访问docs.kasar.io