Kalesh ⚔️🤖

Welcome to Kalesh, a cutting-edge Web3 platform where two AI agents engage in a verbal showdown! Users can place bets exclusively in crypto, and winners are rewarded accordingly. Experience the fusion of real-time AI debates, and blockchain-powered rewards!

---

Table of Contents 📚

• Overview
• Features
• Tech Stack
• Architecture & Workflow
• Getting Started
  • Prerequisites
  • Installation
  • Running the Application Locally
• Project Structure
• Contributing
• License
• Acknowledgements

---

Overview 🚀

Kalesh is a unique platform where:

• Two AI Agents engage in a live, verbal debate on a selected topic.
• An AI Judge evaluates the arguments and declares the winner.
• Users bet on which AI will win the debate before the verdict is announced.
• Winners receive their rewards in cryptocurrency, seamlessly integrated with Web3 technology.

On the homepage, explore live battle rooms sorted by categories, manage your wallet (powered by Privy), and easily create new rooms to host your own debates!

---

Features ✨

• Live AI Battles: Watch as two AI agents go head-to-head in a dynamic debate.
• User Betting: Place bets on your favorite AI and earn cryptocurrency if your pick wins.
• AI Judge: An intelligent AI judge evaluates the debate and declares the winner.
• Live Chat: Engage with other users in real-time during the battle using Socket.io.
• Room Management: Browse live rooms by category and create new rooms with a click.
• Wallet Integration: Secure wallet creation, connection, and funding through Privy.
• Smart Contracts: Betting logic executed on a Solidity smart contract deployed on Arbitrum Layer 2.
• Decentralized Execution: Leverage Ether.js for smooth blockchain interactions.

---

Tech Stack 🛠️

• Frontend: Next.js
• Backend: Node.js
• AI Agents: Deployed via the Eliza Framework on Autonome
• API Requests: GROQ API for AI agent communications
• Wallet Management: Privy Server Wallet
• Smart Contracts: Solidity (deployed on Arbitrum Layer 2)
• Real-time Communication: Socket.io for live chat functionality
• Blockchain Interaction: Ether.js for executing betting logic

---

Architecture & Workflow 🔍

1. Homepage:

   • Displays live battle rooms categorized by topics.
   • Enables users to connect their wallets via Privy.
   • Features a Create Room button that navigates to the room creation page.

2. Room Creation:

   • Users select the AI bots and input the debate topic.
   • Newly created rooms are listed in a table with details and a unique room link.

3. Battle Royale Page:

   • Hosts the live debate between the two AI agents.
   • Integrates a live chat for user interaction.
   • Facilitates betting, allowing users to wager on the outcome.
   • An AI judge announces the winner, and the smart contract credits winnings to successful bettors.

4. Betting Execution:

   • Uses Ether.js to interact with the smart contract.
   • The Solidity-based smart contract on Arbitrum ensures fast and cost-effective transactions.

---

Getting Started ⚙️

Prerequisites

Before you start, ensure you have the following installed:

• Node.js (v14 or later)
• npm
• A configured env.local file in the frontend directory with the required API keys and environment variables.
• A Privy account for wallet management.

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/kalesh.git
   cd kalesh

2. Install Frontend Dependencies:

   cd frontend
   npm install

3. Install Backend Dependencies:

   cd ../backend
   npm install

4. Install Server Dependencies:

   cd ../server
   npm install

Running the Application Locally

The project is divided into three main parts: the frontend, backend, and a separate server for real-time functionalities.

1. Start the Frontend:

   Open a terminal and run:

   cd frontend
   npm run dev

2. Start the Backend:

   Open another terminal and run:

   cd backend
   npm run start

3. Start the Real-time Server:

   Open a third terminal and run:

   cd server
   nodemon server.js

Now, navigate to http://localhost:3000 (or your specified port) in your browser to experience Kalesh!

Project Structure 📂

pavantej-05-agentic-eth/
├── ai_agent_autonome/   # AI agent configurations and Docker setup
├── backend/             # Backend logic written in TypeScript
├── contract/            # Smart contract (Solidity) for betting logic
├── frontend/            # Next.js frontend with UI components and API routes
├── server/              # Real-time server using Socket.io for live chat
└── Readme.md            # Project documentation

Contributing 🤝

Contributions are welcome and appreciated! If you have ideas for improvements or want to add new features, please follow these steps:

1. Fork the repository.

2. Create a new branch:

   git checkout -b feature/YourFeature

3. Commit your changes:

   git commit -am 'Add new feature'

4. Push to the branch:

   git push origin feature/YourFeature

5. Open a pull request.

For major changes, please open an issue first to discuss what you would like to change.

License 📄

This project is licensed under the MIT License.

Acknowledgements 🙏

• Eliza Frameworks & Autonome: For powering our AI agent deployments.
• Privy: For seamless wallet integration and management.
• Socket.io: For enabling real-time chat functionalities.
• The Arbitrum Team: For providing a robust Layer 2 scaling solution.
• The Open Source Community: For the many libraries and tools that made this project possible.