hackquest logo

Vireo-Vigia-sdk

DeFi protocols spend $5K–15K/month on human support answering the same questions every day: "Why is my health factor dropping?", "Am I close to liquidation?", "How do I reduce my exposure?". Teams answer manually. Users get liquidated while waiting. Vireo Vigía is an open-source Python SDK that deploys a 24/7 AI support agent directly into your protocol's Discord or Telegram. Unlike generic chatbots, it reads each user's real wallet — live Aave V3 health factors, GMX V2 positions, Hyperliquid balances — and answers with their actual numbers, not generic advice. When a user asks "why is my health factor dropping?", the bot responds: "Your WETH collateral is $8,200, USDC debt $4,100, health factor 1.42. If ETH drops 22% you hit liquidation. Reduce debt by ~$800 to reach a safe 1.7." Built on Arbitrum integrations (Aave V3, GMX V2), RAG over protocol docs, and Anthropic Claude. Embeddings run locally — the only API key required is Anthropic. MIT licensed, self-hostable, or available as a managed service.

Videos

Tech Stack

Python
Web3

Description

Open-source Python SDK for deploying wallet-aware AI support agents in DeFi protocols on Arbitrum. Reads live on-chain positions (Aave V3, GMX V2, Hyperliquid) and answers users' questions about their actual portfolio — not textbook examples. Deploys to Discord or Telegram in under an hour.

Progress During Hackathon

Built the core SDK from scratch during the buildathon: RAG pipeline over protocol docs, live on-chain position reader for Aave V3 and GMX V2 on Arbitrum, proactive liquidation alerts via /monitor, and Discord + Telegram channel integrations. Shipped 280 passing tests, full CI pipeline (ruff + mypy + bandit), and a working Discord bot demo. The SDK is MIT licensed, self-hostable, and ready for protocol teams to deploy in under an hour.

Fundraising Status

Bootstrapped. Pre-seed, not actively raising. Open to strategic partnerships with DeFi protocols.
Team Leader
DDavid Olarte
Project Link
Sector
DeFiAISocialFi