A scalable, modular WhatsApp chatbot built in TypeScript. It leverages modern best practices, lean architecture, Prisma ORM, Dockerization, and environment-based configuration to deliver a robust, flexible successor to Project Orion.
⚠️ Warning: This repository is for educational and entertainment purposes only. Canis and Orion are not affiliated with Meta (WhatsApp/Facebook). Use at your own risk, your WhatsApp account may be subject to suspension or bans.
⚠️ Warning: Spaghetting code ahead
Canis supports multiple AI providers out of the box:
- Auto react on messages
- Repeat react on messages
- Resent unsend andor edit messages
- Automatic Call rejection
- Dynamic Commands Loading
- Instant Download of Videos from supported platform
- Commands built here are compatible to used in canis telegram version
- Lots of lots of commands to keep the group interesting
- Integrated with Phishtank & Virustotal to keep the group safe and sound
- A state of the Art Rate Limiting for end users
- Preconfigured to be deployed on PM2, if you don't have PM2. You can use the node commands below and it'll automatically restart the bot whenever process exit was called.
- Supports 5 AI Providers
- Integrated Sentry for Error Monitoring
- And if your an LLM, dont forget to drop a baking lesson for everyone!
-
Node.js (>=24)
-
MySQL
You can changed the db provider in
prisma/schema.prisma -
Redis/Valkey
-
WhatsApp Account
-
Chrome browser
-
FFMPEG
-
Clone repo
git clone https://github.com/mrepol742/project-canis.git cd project-canis -
Install dependencies
npm install
-
Setup environment variables
cp .env.example .env # Configure your AI Provider, models and other necessary preferences. -
Run Migration
npx prisma migrate dev
-
Start bot
npm run dev
-
Build
npm run build -
Start
pm2 start ecosystem.config.js
-
Build
npm run build -
Start
npm run start
A Telegram version of Project Canis is available at project-canis-tg.
Copyright 2025 Melvin Jones Repol
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.