SplitEasy Agent

SplitEasy is an AI-powered bill splitting agent on Telegram, built for the Celo Hackathon. It allows groups to split expenses via natural language (text or voice) and settle debts instantly using Celo cUSD.

🚀 Features

• Natural Language Parsing: "Split dinner $45 between Alice, Bob, and me."
• Voice Commands: Send a voice note, and the agent parses it (via ElevenLabs).
• Fair Splitting: Supports equal splits, specific amounts, and adjustments.
• Celo Integration: Settles debts on the Alfajores Testnet using cUSD.
• Confirmation Flow: Interactive Telegram buttons to confirm transactions before sending.

🛠 Tech Stack

• Bot Framework: telegraf (Node.js)
• AI Agent: OpenClaw (connected via HTTP)
• Voice/Audio: ElevenLabs API (STT & TTS)
• Blockchain: viem (Celo Alfajores)

📦 Setup

1. Clone the repository ```bash git clone cd spliteasy-agent ```

2. Install Dependencies ```bash npm install ```

3. Configure Environment Copy .env.example to .env and fill in: ```env TELEGRAM_BOT_TOKEN=your_bot_token ELEVENLABS_API_KEY=your_elevenlabs_key CELO_PRIVATE_KEY=your_testnet_private_key OPENCLAW_URL=http://127.0.0.1:18789/chat ```

▶️ Running the Bot

1. Start the OpenClaw Agent (Ensure your OpenClaw instance is running at the configured URL).

2. Start the Telegram Bot ```bash npm run dev:bot ```

🧪 Testing & Verification

1. Text: Send "Split $10 between Alice and Bob".
2. Voice: Record "I paid $20 for lunch, split with John."
3. Confirmation: Click "✅ Confirm Split" to trigger the mock Celo transaction.

⚠️ Disclaimer

• This is a Hackathon MVP.
• Private keys are stored in .env for demo purposes only. NEVER do this in production.
• Transactions run on Celo Alfajores Testnet.