Skip to content

kaif-builds/Flow_Pilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

53 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Flow Pilot: The Future of Autonomous DeFi Automation

A comprehensive DeFi platform built on the Flow blockchain, featuring yield farming, and AI-powered trading agents. Flow Pilot demonstrates the future of decentralized finance with automated transaction scheduling, composable agent strategies, and a beautiful modern UI.


🌐 Live Demo & Resources


🎯 Project Overview

Flow Pilot is built entirely on Flow blockchain and leverages Forte Actions-Flow's revolutionary transaction scheduling to enable true on-chain DeFi automation. Users mint AI trading agents as NFTs, deposit tokens into yield farms, and activate automated strategies that execute and adapt in real-time, all without manual intervention. Every core feature, agent, and strategy runs natively on Flow for maximum security, composability, and transparency.

πŸ…Prize Criteria Fulfillment

Below are the major hackathon prize categories that Flow Pilot fulfills, with explanations and highlights:

tabel

πŸ“‹ Table of Contents

  • [Features]
  • [Tech Stack]
  • [Prerequisites]
  • [Project Structure]
  • [Installation & Setup]
  • [Running the Application]
  • [Using the Platform]

✨ Features

  • Create AI Agent NFTs: Design unique AI agents with custom personalities and skills
  • NFT Marketplace: Buy and sell Agent NFTs with other users on Flow Testnet
  • Personal Dashboard: View and manage your NFT collection
  • Leaderboards: Track top collectors and marketplace activity
  • Analytics: View market trends and collection statistics
  • Wallet Integration: Connect with Flow wallets for secure transactions

πŸ›  Tech Stack

Frontend

  • Next.js 15.5.5 - React framework with Turbopack
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • FCL (Flow Client Library) - Flow blockchain integration

Blockchain

  • Flow Testnet - Layer 1 blockchain
  • Cadence - Smart contract language
  • Contract Address: 0x8b32c5ecee9fe36f

πŸ“¦ Prerequisites

Before you begin, ensure you have the following installed:

Required Software

Node.js (v18 or higher)

node --version  # Should be v18+

Download from: https://nodejs.org/

npm (v9 or higher)

npm --version  # Should be 9+

Git

git --version

πŸ“ Project Structure

Pilot_FINAL/
β”œβ”€β”€ frontend/               # Next.js application
β”‚   β”œβ”€β”€ pages/             # Pages directory
β”‚   β”‚   β”œβ”€β”€ dashboard.tsx  # User dashboard - View collection
β”‚   β”‚   β”œβ”€β”€ leaderboards.tsx # Rankings and leaderboards
β”‚   β”‚   β”œβ”€β”€ buy-sell.tsx   # Buy/Sell marketplace
β”‚   β”‚   β”œβ”€β”€ analytics.tsx  # Analytics and data
β”‚   β”‚   β”œβ”€β”€ farms.tsx      # Mint new Agent NFTs
β”‚   β”‚   └── app.tsx        # Main app component
β”‚   β”œβ”€β”€ components/        # React components
β”‚   β”œβ”€β”€ flow/             # Flow blockchain configuration
β”‚   β”‚   └── config.js     # FCL configuration (Testnet)
β”‚   β”œβ”€β”€ public/           # Static assets
β”‚   β”œβ”€β”€ styles/           # CSS styles
β”‚   └── package.json      # Dependencies
β”œβ”€β”€ cadence/              # Smart contracts
β”‚   β”œβ”€β”€ contracts/        # Contract files
β”‚   β”‚   └── AgentNFT.cdc  # Main NFT contract
β”‚   β”œβ”€β”€ transactions/     # Transaction scripts
β”‚   └── scripts/          # Query scripts
β”œβ”€β”€ .gitignore           # Git ignore rules
β”œβ”€β”€ flow.json            # Flow project configuration
└── README.md           # This file

πŸš€ Installation & Setup

Step 1: Clone the Repository

git clone https://github.com/kaif-builds/Flow_Pilot.git
cd Pilot_FINAL

Step 2: Navigate to Frontend

cd frontend

Step 3: Install Dependencies

npm install

This will install all required packages including:

  • Next.js
  • React
  • Flow Client Library (FCL)
  • Tailwind CSS
  • Other dependencies

πŸƒ Running the Application

Start the Development Server

From the frontend directory:

npm run dev

You should see:

β–² Next.js 15.5.5 (Turbopack)
   - Local:        http://localhost:3000
   - Network:      http://192.168.29.173:3000
   - Environments: .env.local
 βœ“ Starting...
 βœ“ Ready in 618ms

FCL Config loaded for Testnet: {
  accessNode: 'https://rest-testnet.onflow.org',
  discoveryWallet: 'https://fcl-discovery.onflow.org/testnet/authn'
}

βœ… Access the Application

Open your browser and navigate to:

http://localhost:3000

That's it! Your app is now running and connected to Flow Testnet.


πŸ”— Connect Your Wallet

  1. Click "Connect Wallet" in the application
  2. Choose your preferred Flow wallet:
    • Blocto (recommended for beginners)
    • Other Flow-compatible wallets
  3. Follow the wallet prompts to connect
  4. Approve the connection

πŸ’‘ Using the Platform

Available Pages

  1. Dashboard (/dashboard)
    • View and manage your Agent NFT collection
    • See all your minted NFTs
    • Access NFT details and actions
    • Track your portfolio value
mmfinal
  1. Farms (/farms)
    • Create and mint new Agent NFTs
    • Design your AI agents with custom attributes
    • Mint your agents to the blockchain
mm4
  1. Buy/Sell (/buy-sell)
    • Browse marketplace listings
    • Purchase Agent NFTs from other users
    • List your NFTs for sale
    • Make offers and complete transactions
mmbuy
  1. Leaderboards (/leaderboards)
    • View top collectors and traders
    • Track marketplace statistics
    • See trending Agent NFTs
    • Compare your ranking
mmlead
  1. Analytics (/analytics)
    • View market trends and data
    • Analyze NFT performance
    • Track your collection value
    • See historical transaction data
mmanl

πŸ“š Resources



πŸ“ž Support


πŸ™ Acknowledgments

  • Flow Blockchain Team
  • Cadence Language Developers

Built with ❀️ on Flow Blockchain

For questions or feedback, please open an issue on GitHub.

About

Flow Pilot is a DeFi platform built on the Flow blockchain, combining yield farming with AI-powered trading agents. It enables automated transaction scheduling, composable strategy execution, and delivers a seamless modern user experience

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors