https://github.com/edycutjong/gustack
🧩 Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop.
https://github.com/edycutjong/gustack
ai-agents frontier hackathon nextjs policy-engine solana starter-kit zerion
Last synced: 2 days ago
JSON representation
🧩 Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop.
- Host: GitHub
- URL: https://github.com/edycutjong/gustack
- Owner: edycutjong
- License: mit
- Created: 2026-05-10T12:45:04.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-11T03:08:29.000Z (about 1 month ago)
- Last Synced: 2026-05-11T05:15:34.584Z (about 1 month ago)
- Topics: ai-agents, frontier, hackathon, nextjs, policy-engine, solana, starter-kit, zerion
- Language: TypeScript
- Homepage: https://gustack.edycu.dev
- Size: 1.09 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Gustack 🚀
Forkable agent starter kit with ALL 3 Zerion policy types + AI correction loop. The create-react-app for autonomous agents.
[](https://gustack.edycu.dev)
[](https://gustack.edycu.dev/pitch)
[](https://youtu.be/7GPrTMARZUs)
[](https://superteam.fun/earn/listing/build-a-autonomous-onchain-agent-using-zerion-cli)
[](https://github.com/edycutjong/gustack/actions/workflows/ci.yml)
---
## 📸 See it in Action
*(Demo GIF and UI screenshots can be found in the `docs/assets` directory)*
[**▶️ Watch the Demo Video**](https://youtu.be/7GPrTMARZUs)
## 💡 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](docs/ARCHITECTURE.md).
## 🧩 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:**
```bash
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](LICENSE).