FlowGov

# FlowGov

## Overview

FlowGov is a fork of the [Toucans DAO project](https://github.com/emerald-dao/project-toucans-v2) with enhanced features for Flow blockchain governance. This project extends the original Toucans DAO functionality with AI-powered governance assistance and automated workflow capabilities using Flow's Forte upgrade.

You can find the app deployed on [Netlify](https://flow-gov.netlify.app/).

Built for Forte Hacks by Flow: Build with Disney, Dune and Dapper

This project was developed as part of [Forte Hacks](https://www.hackquest.io/hackathons/Forte-Hacks?utm=MENA), Flow's 2025 flagship hackathon running from October 1-31st. The hackathon invites hackers, creators, and Web3 developers to push the boundaries of smart contract automation, DeFi primitives, and user-centric applications to win a share of $250,000 in bounties and prizes. Supported by partners including Dune, Quicknode, Moonpay, Dapper Labs, Thirdweb, Privy, Crossmint, and more.

## New Features

### 1. AI Governance Agent (Frontend)

An intelligent, conversational interface that helps users navigate and understand Flow governance proposals.

Key Capabilities:

- Fetches all available Flow governance proposals

- Provides a chat-based UI for natural language queries

- Answers questions about proposal content, voting history, and current status

- Displays loading states and error handling

- Secure implementation (no API keys exposed on frontend)

Acceptance Criteria:

- ✅ Fetch all Flow governance proposals on the frontend

- ✅ Simple chat UI component for the Gov Agent

- ✅ AI model integration for answering proposal-related questions

- ✅ Answer basic questions (title, description, status, voting info)

- ✅ Loading state display while agent responds

- ✅ Error message handling for failed requests

- ✅ No API keys exposed on frontend

### 2. Forte Integration (Onchain)

Leverages Flow's Forte network upgrade to enable composability and automation for governance operations.

Forte Features:

- Actions: Standardized, reusable building blocks for governance operations

- Workflows: Composable sequences that automate governance processes

- Time-based triggers: Schedule governance actions and automated voting

Reference: [Forte: Introducing Actions & Agents](https://www.flow.com/post/forte-introducing-actions-agents-supercharging-composability-and-automation)

Acceptance Criteria:

- ✅ Forte SDK/dependencies setup

- ✅ Forte connection to Flow network configured

- ✅ Basic Action definitions for governance operations (submit proposal, cast vote)

- ✅ Simple Workflow example chaining governance actions

- ✅ Connection testing and Action trigger verification

- ✅ Documentation of Forte setup and usage

## Original Toucans DAO

This project builds upon the Toucans DAO framework, which provides the foundational DAO infrastructure for the Flow blockchain. The original project is included as a git submodule in the project-toucans-v2 directory.