SuiMind is not just a wallet you talk to—it's an agent that acts for you.
Powered by Google Gemini 3.1 and the Sui Blockchain, SuiMind transforms natural language into executed financial intents. From sending assets to analyzing complex on-chain data, SuiMind bridges the gap between human thought and blockchain execution.
Traditional wallets are reactive readers. SuiMind is a proactive executor.
Most AI wallets are glorified search engines. SuiMind builds and prepares transactions for you in real-time.
- You say: "Send 10 SUI to Alex for dinner."
- SuiMind acts: Instantly constructs a
TransferObjecttransaction, resolves the address, and presents a "Sign Now" card.
Don't just check balances. Ask deep questions.
- You say: "How much gas did I spend on transactions last week?"
- SuiMind acts: Dynamically generates complex GraphQL queries to fetch, aggregate, and explain your on-chain history in plain English.
We don't rely on a single prompt. SuiMind employs a sophisticated Multi-Agent System using the Google Agent Development Kit (ADK):
- Mindy (Router): The central orchestrator that routes requests to specialized agents.
- Greeting/Farewell Agents: Handle conversational pleasantries.
- Parser Agent: Decodes user intent from natural language.
- Analyst Agent: Queries live blockchain data and staking APYs.
- Query Agent: Executes GraphQL queries for transactions, balances, and staking data.
- Transaction Agent: Securely constructs transaction payloads (transfers & payment requests).
Manage your assets with the speed of thought.
- Send Assets: "Transfer 50 USDC to 0x..."
- Request Payments: "Create a payment link for 5 SUI from 0x..."
- Reject Requests: "Reject that last payment request."
Stop guessing where to stake. SuiMind fetches live Validator APY data directly from the Sui network / fullnodes.
- Feature: "What's the current staking APY?" -> Returns real-time validator performance metrics.
Built with Next.js 14, Tailwind CSS, and Framer Motion, the interface feels like a modern fintech app, not a crypto tool.
- Visuals: Frosted glass aesthetics, smooth transitions, and responsive data visualization.
- Interactivity: Dynamic "Orb" animations that react to AI thinking states.
SuiMind is a hybrid application combining a powerful Python-based AI backend with a reactive Next.js frontend.
- Framework: Python / Google Agent Development Kit (ADK)
- Intelligence: Gemini 3.0 Flash (Optimized for low-latency reasoning)
- Agents:
Mindy(Router)greeting_agent/farewell_agent(Conversational)parser_agent(Intent Extraction)analyst_agent(Data Analysis)query_agent(GraphQL Execution)transaction_agent(Payload Construction)
- Framework: Next.js 14 (App Router)
- Styling: Tailwind CSS + Framer Motion
- Sui Integration:
@mysten/sui.jsfor signature management and zkLogin.
- Docker and Docker Compose (Recommended)
- Node.js 18+ (For manual setup)
- Python 3.10+ (For manual setup)
- A Sui Wallet (e.g., Sui Wallet, Ethos)
- Clone the Repository
git clone https://github.com/Elivius/SuiMind.git cd SuiMind
-
Set up Environment Variables
- Create a
.envfile in theai-agents/directory and add your Google API key:GOOGLE_API_KEY=your_api_key_here
- Create a
-
Run the Application
docker-compose up -d
- The Frontend will be available at
http://localhost:3000 - The AI Backend will be available at
http://localhost:8080
- The Frontend will be available at
-
Setup AI Backend
cd ai-agents python -m venv .venv source .venv/bin/activate # or .venv\Scripts\activate on Windows pip install -r requirements.txt
Create a
.envfile inai-agents/with yourGOOGLE_API_KEY. -
Setup Frontend
cd ../frontend npm install -
Run the Application
- Backend:
python run.py(Runs on port 8080) - Frontend:
npm run dev(Runs on port 3000)
- Backend:
SuiMind challenges the status quo of "Chatbots in Crypto." By focusing on Execution (C2E) and Live Data fetching, we provide a glimpse into the future of Agentic Finance on Sui.
Built with ❤️ for the Gemini 3 Hackathon.