SuiMind is not just a wallet you talk to—it's an agent that acts for you.
Powered by Google Gemini 3 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 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.