Optimized Messenger Pagebot.
Easy to set up and customize for your own page.
Built by a solo dev
Created by Seth Asher Salinguhay
| Directory | Description |
|---|---|
modules/commands/ |
Bot Logic (AI, Media, Fun, Utility, Admin commands) |
modules/core/ |
System Core (Database, Cache & Queue Managers) |
modules/middleware/ |
Security (Rate limiting & Input Validation) |
modules/utils/ |
Utilities (Helper functions and tools) |
page/src/ |
Interface (Facebook API Wrappers) |
config/ |
Configuration (API Endpoints & Constants) |
index.js |
Entry Point (Main Application File) |
webhook.js |
Webhook Handler (Facebook Messenger webhook processing) |
- Node.js >= 16.0.0
- MongoDB (optional but recommended)
- Clone the repository
- Install dependencies:
npm install - Copy
.env.exampleto.envand configure - Start:
npm startornpm run devfor development
npm start- Production modenpm run dev- Development with nodemonnpm test- Run testsnpm run lint- Check code stylenpm run lint:fix- Fix code style issuesnpm run format- Format code with Prettiernpm run health- Check application healthnpm run logs- View application logs
- Use 4 spaces for indentation
- Single quotes for strings
- No trailing semicolons
- No inline comments
- Human-readable variable names
# Required
PAGE_ACCESS_TOKEN=your_token
VERIFY_TOKEN=your_verify_token
ADMINS=your_facebook_id
# Database
MONGODB_URI=your_mongodb_uri
# AI Services
OPENAI_API_KEY=your_openai_key
CHIPP_API_KEY=your_chipp_key
CHIPP_MODEL=gpt-4
# Redis (for high-load deployments)
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password
# External APIs
DICT_API_KEY=your_dict_key
GOOGLE_API_KEY=your_google_key
GOOGLE_CX=your_google_cx
NASA_API_KEY=your_nasa_key
WOLFRAM_APP_ID=your_wolfram_id
APY_TOKEN=your_apy_token
# Server Configuration
NODE_ENV=production
PORT=8080
BOT_NAME=Amdusbot
APP_SECRET=your_app_secret
LOG_LEVEL=infonpm install
node index.js3. Set up Facebook Webhook
- Point your webhook to
https://your-domain.com/webhook - Subscribe to
messagesandmessaging_postbacks
amdus— Main AI engine with image analysisgemini— Google Gemini integrationcopilot— Microsoft Copilot with web searchperplexity— Deep reasoning AIvenice— Precise AI modelwebpilot— Web search AI assistantyou— You.com AI searchsim— SimSimi chatbot
alldl— Universal media downloaderpinterest— Image searchscreenshot— Website preview capturedalle— AI image generationgmage— Google image searchlyrics— Song lyrics fetchernasa— NASA space photo of the day
tempmail— Disposable email generatorremind— Scheduled reminderstrans— Text translation with audiodict— Dictionary and slang definitionsgoogle— Google web searchwiki— Wikipedia searchwolfram— Computational knowledgepokemon— Pokédex lookupjoke— Random jokes48laws— 48 Laws of Power
stats— System metricsgetuser— User database managementban/unban— User access controlbroadcast— Global announcementsmaintenance— Toggle maintenance modecmd— Enable/disable commands
MIT License — Free to use, modify, and distribute.
If you find this project useful, please star the repository and follow the Facebook page.
Open-source and maintained by Sethdico.