Gustack 🚀

Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop. The create-react-app for autonomous agents.

---

📸 See it in Action

(Demo GIF and UI screenshots can be found in the docs/assets directory)

▶️ Watch the Demo Video

💡 The Problem & Solution

Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop. The create-react-app for autonomous agents.

Gustack solves this by providing: Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop. The create-react-app for autonomous agents.

Key Features:

• ⚡ High Performance: Seamless integration and optimized workflows.
• 🔒 Secure by Design: Verifiable on-chain actions and robust data protection.
• 🎨 Intuitive UX: Beautiful, user-centric interface built for scale.

🏗️ Architecture & Tech Stack

Tech Stack

Component	Technology	Description
Frontend	Next.js 16, React 19	App Router, SSR, Server Components
Styling	Tailwind CSS v4	High-performance responsive UI
Language	TypeScript	Strict type safety across the stack
Integration	Zerion API	Portfolio and wallet data tracking
Testing	Vitest	Comprehensive unit and component testing

For a detailed breakdown of our system architecture and data flow, please refer to the Architecture Document.

🧩 How We Use Zerion

Gustack fundamentally relies on Zerion to function:

1. Portfolio Tracking: We use Zerion's API to fetch real-time portfolio data and token balances across multiple networks.
2. Policy Enforcement: We integrate all 3 Zerion policy types to ensure secure and compliant agent operations.

🏆 Sponsor Tracks Targeted

• Sponsor Integration: Zerion (Check docs/SPONSOR_DEFENSE.md for our full sponsor integration strategy)

🚀 Run it Locally (For Judges)

1. Clone the repo: git clone https://github.com/edycutjong/gustack.git
2. Install dependencies: npm install
3. Set up environment variables:

   cp .env.example .env.local

   Note: Set your ZERION_API_KEY and NEXT_PUBLIC_ZERION_API_KEY in the .env.local file.
4. Run the app: npm run dev

Note for Judges: Detailed submission materials, demo scripts, and sponsor defenses are located in the docs/ directory.

---

📄 License

This project is licensed under the MIT License.