Skip to content

Shahzuby/QuestPilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ QuestPilot — Zealy & Galxe Auto-Pilot

Open Source browser automation tool that auto-completes quests on Zealy.io and Galxe across multiple Chrome profiles. Zero manual work — fully A2Z automated.

Node.js License Platform Open Source

🔥 What Does It Do?

QuestPilot connects to your real Chrome browser profiles and automatically completes quests/tasks on Zealy and Galxe platforms. It uses stealth browser automation — no API keys needed, just your logged-in Chrome profiles.

✅ Supported Task Types

Task Type Zealy Galxe
Twitter Follow
Twitter Like / Retweet
Twitter Reply / Quote
Discord Join
Telegram Join
Visit URL
Quiz / Multiple Choice
Text Submission
Daily Check-in
Watch Video
Space Follow
Credential / Reward Claim

🛡️ Anti-Ban Features

  • Uses real Chrome profiles with existing sessions (same fingerprint as manual browsing)
  • Runs in headful mode (visible browser, not headless)
  • Stealth plugin removes all automation detection markers
  • Human-like behavior — bezier curve mouse movements, random typing speed, natural scrolling
  • Random delays (2-8 seconds) between every action
  • Sequential execution — one profile at a time, not parallel
  • Runs on your local machine (home IP, not data center)
  • Tracks completed tasks — never re-attempts finished ones

📋 Requirements

  • Node.js v18 or higher — Download here
  • Google Chrome browser installed with profiles set up
  • Your Chrome profiles must be logged in to Zealy/Galxe (and Twitter/Discord if doing social tasks)

🚀 Installation (Step by Step)

Step 1: Install Node.js

Download and install Node.js LTS from https://nodejs.org

After installing, open a new terminal and verify:

node -v
npm -v

Both commands should show version numbers.

Step 2: Clone This Repository

git clone https://github.com/Shahzuby/QuestPilot.git
cd QuestPilot

Step 3: Install Dependencies

npm install

Step 4: Start The Tool

npm start

You should see:

  ⚡ QuestPilot — Zealy & Galxe Auto-Pilot
  🌐 Dashboard: http://localhost:3000
  📁 Logs: ./logs/

  👤 Detected 5 Chrome profiles:
      O Profile 1
     ✅ Profile 2
     ...

Step 5: Open The Dashboard

Open your browser and go to: http://localhost:3000


📖 How To Use

1. Select Profiles

  • The dashboard auto-detects all your Chrome profiles
  • Click on profiles to select/deselect them
  • Use "Select All" / "Deselect All" buttons for quick selection
  • Use the search box to find specific profiles by name
  • The counter shows how many profiles are selected (e.g., 4 / 15 selected)

2. Set Target Quest (Optional)

Paste a specific quest URL to complete it across all selected profiles:

  • Zealy: https://zealy.io/cw/your-community/questboard
  • Galxe: https://app.galxe.com/quest/your-campaign

If you leave this empty, the tool will try to auto-detect available quests.

3. Choose Platform

Select which platform to automate:

  • Both — Zealy + Galxe
  • Zealy — Only Zealy quests
  • Galxe — Only Galxe quests

The platform auto-detects from the URL you paste.

4. Start Automation

Click "🚀 Start All Profiles" and watch the magic!

The tool will:

  1. Launch Chrome with your first selected profile
  2. Navigate to the target quest URL
  3. Detect all uncompleted tasks
  4. Complete each task automatically (Twitter follow, quiz, visit URL, etc.)
  5. Claim rewards/XP
  6. Close browser
  7. Wait 10-20 seconds
  8. Move to next profile
  9. Repeat until all profiles are done

5. Monitor Progress

  • Live Log shows real-time task completion with colored messages
  • Stats Bar shows profiles count, tasks done, runtime, and current status
  • Profile cards highlight which profile is currently running

🔧 How Chrome Profiles Work

QuestPilot uses your existing Chrome profiles. Here's how to set them up:

Creating Chrome Profiles

  1. Open Google Chrome
  2. Click your profile icon (top right)
  3. Click "Add" to create a new profile
  4. Give it a name (e.g., "Account 1", "Account 2")
  5. Log in to Zealy, Galxe, Twitter, and Discord in each profile

Important Notes

  • Each Chrome profile has its own cookies, sessions, and logins
  • QuestPilot opens the actual profile — all your logged-in sessions are preserved
  • Do NOT open the same Chrome profile manually while the tool is running
  • After the tool finishes, you can use your profiles normally

📁 Project Structure

QuestPilot/
├── server.js                    # Express server + WebSocket + automation engine
├── package.json                 # Dependencies
├── lib/
│   ├── profile-manager.js       # Auto-detect Chrome profiles
│   ├── browser-engine.js        # Puppeteer stealth browser launcher
│   ├── human-behavior.js        # Human-like mouse/typing/scroll simulation
│   ├── zealy-bot.js             # Zealy A2Z task automation
│   ├── galxe-bot.js             # Galxe A2Z task automation
│   ├── social-handler.js        # Twitter/Discord/Telegram auto-actions
│   ├── quiz-solver.js           # Quiz auto-answer with caching
│   └── logger.js                # Logging (console + file + WebSocket)
├── public/
│   ├── index.html               # Dashboard UI
│   ├── css/style.css            # Dark theme styling
│   └── js/app.js                # Frontend logic
├── data/
│   ├── completed.json           # Completed task tracking
│   └── quiz-cache.json          # Cached quiz answers
└── logs/                        # Per-profile log files

⚠️ Important Disclaimers

  • This tool is for educational purposes and to help the community complete quests efficiently
  • Use at your own risk — while anti-ban measures are in place, no tool can guarantee 100% safety
  • Do not run on VPS/data center — use only on your local machine with residential IP
  • The developers are not responsible for any account bans or issues
  • Make sure your Chrome profiles are logged in to all required platforms before running

🤝 Contributing

Contributions are welcome! Feel free to:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is open source and available under the MIT License.


⭐ Star This Repo

If you find this tool useful, please give it a ⭐ on GitHub! It helps others discover it.


Built with ❤️ for the Web3 community

About

Zealy & Galxe Quest Auto-Pilot Open source browser automation for completing Web3 quests across multiple Chrome profiles

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors