🖥️ Full Control with Self-Hosting

🚀 Self-Hosting Guide

BigBull.AI is designed to be fully self-hosted, giving you complete control over your trading strategies, data, and operations. Follow this guide to set up and run your own instance of BigBull.AI on your server or local machine.

For a quick overview of how BigBull.AI works, check out our System Overview or explore the Features List.

---

🔎 Prerequisites

Make sure you have the following ready before starting:

✅ Server/Cloud Instance or Local Machine – Examples: AWS, DigitalOcean, or your PC ✅ Node.js – Version 23+ installed ✅ Git – To clone the repository ✅ pnpm – Install globally with:

npm install -g pnpm

✅ Basic Knowledge – Familiarity with TypeScript/Node.js is recommended ✅ API Keys – For Binance, OpenAI, and other services

---

⚙️ Installation Steps

1. Clone the Repository

Clone the repository and switch to the correct directory:

git clone https://github.com/PLACEHOLDER/bigbullai.git  
cd bigbullai/core  

---

2. Install Dependencies

Install all required dependencies:

pnpm install  

---

3. Configure Environment Variables

Create a .env file in the root directory with your configuration:

cp .env.example .env  

Edit the .env file and fill in your details:

# API Keys  
OPENAI_API_KEY=your_openai_api_key  
BINANCE_API_KEY=your_binance_api_key  
BINANCE_API_SECRET=your_binance_api_secret  

# Blockchain Configuration  
PRIVATE_KEY=your_private_key  
NETWORK=mainnet  # or testnet  

# Optional Services  
TRADING_VIEW_API_KEY=your_trading_view_api_key  

# Web Interface  
CLIENT_URL=http://localhost:3000  

---

4. Build the Project

Compile the project code:

pnpm build  

---

5. Start the Server

Launch the BigBull.AI server:

pnpm start  

---

6. Set Up the Web Client (Optional)

In a new terminal window:

cd ../client  
pnpm install  
pnpm run dev  

Your web interface will be available at http://localhost:3000 or your server's address.

---

🔧 Support & Maintenance

🌐 Community Support

Need help? Join our Discord for real-time assistance, strategy discussions, and updates.

📥 Regular Updates

To keep your instance up to date: 🔹 Regularly pull updates from the repository 🔹 Check for new features and improvements 🔹 Apply security updates as needed

📖 Documentation

For troubleshooting and advanced configuration: 🔹 Review our technical documentation 🔹 Check the plugin documentation 🔹 Explore the development guides

---

✨ Enjoy full control over your BigBull.AI instance and experience next-level, AI-powered DeFi trading! 🚀