Snak: Effortless Coiling, Sleek Performance

Key Features of Snak: Effortless Coiling, Sleek Performance?

• Multi-AI Support: Leverage models from Anthropic, OpenAI, Google Gemini, and Ollama within the same framework, enabling seamless switching between providers for optimal performance.
• Dual Mode Flexibility: Deploy as a full-stack NestJS server with a user-friendly web interface or embed the lightweight library into existing applications for maximum adaptability.
• Autonomous Workflows: Schedule automated tasks like balance monitoring or transaction alerts via configurable JSON-based agent profiles—ideal for 24/7 blockchain oversight.
• Modular Action System: Extend functionality with plugin-based actions (e.g., token transfers, smart contract interactions) through a well-documented API.

Use Cases of Snak: Effortless Coiling, Sleek Performance?

Snak’s versatility shines in scenarios such as:

• Deploying autonomous agents to monitor Starknet balances and trigger alerts via Discord when thresholds are breached.
• Building conversational interfaces that let users execute transfers, check account statuses, or analyze on-chain data through natural language.
• Creating compliance bots for automated audit logging or cross-chain transaction validation in enterprise-grade applications.

FAQ from Snak: Effortless Coiling, Sleek Performance?

How do I choose between server and library modes?

Select server mode for rapid prototyping with a built-in interface, or opt for library mode for seamless integration into your existing backend infrastructure.

Can I customize the AI models and actions?

Yes! Snak supports dynamic model switching and allows developers to extend functionality through plugin-based actions documented here.

Does Snak work with testnets?

Absolutely. Simply update the STARKNET_RPC_URL in your config to point to a testnet endpoint like https://alpha4.starknet.io.

A toolkit for creating AI agents that can interact with the Starknet blockchain. Available as both an NPM package and a ready-to-use NestJS server with a web interface. Supports multiple AI providers including Anthropic, OpenAI, Google Gemini, and Ollama.

Quick Start

Prerequisites

• Starknet wallet (recommended: Argent X)
• AI provider API key (Anthropic/OpenAI/Google Gemini/Ollama)
• Node.js and pnpm installed

Installation

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

Configuration

Create a .env file:

# Starknet configuration (mandatory)
STARKNET_PUBLIC_ADDRESS="YOUR_STARKNET_PUBLIC_ADDRESS"
STARKNET_PRIVATE_KEY="YOUR_STARKNET_PRIVATE_KEY"
STARKNET_RPC_URL="YOUR_STARKNET_RPC_URL"

# AI Provider configuration (mandatory)
AI_PROVIDER_API_KEY="YOUR_AI_PROVIDER_API_KEY"
AI_MODEL="YOUR_AI_MODEL"
AI_PROVIDER="YOUR_AI_PROVIDER"

# NestJS server configuration
SERVER_API_KEY="YOUR_SERVER_API_KEY"
SERVER_PORT="YOUR_SERVER_PORT"

# Agent additional configuration
DISCORD_BOT_TOKEN?="YOUR_DISCORD_BOT_TOKEN"
DISCORD_CHANNEL_ID?="YOUR_DISCORD_CHANNEL_ID"

Usage

Server Mode

Run the server:

pnpm run start

Available Modes:

1. Chat Mode : Have conversations with the agent

* Check balances
* Execute transfers
* Manage accounts

2. Autonomous Mode : Configure automated monitoring Set up in config/agents/config-agent.json:

   {
   "name": "MyAgent",
   "context": "You are a Starknet monitoring agent...",
   "interval": 60000,
   "chat_id": "your_discord_channel_id",
   "allowed_actions": ["get_balance", "get_block_number"],
   "prompt": "Monitor ETH balance and alert if it drops below 1 ETH..."

}

Library Mode

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',
});

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

Actions

To learn more about actions you can read this doc section. A comprehensive interface in the Kit will provide an easy-to-navigate catalog of all available plugins and their actions, making discovery and usage simpler.

To add actions to your agent you can easily follow the step-by-steps guide here

Contributing

Contributions are welcome! Feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

---

For detailed documentation visit docs.kasar.io