Caligo
A SelfBot for Telegram made with Python using Pyrogram library. It's highly inspired from pyrobud that writtens in Telethon library.
It's the same but different, you know what i mean?
Caligo needs Python 3.8 or newer to run.
Compatibility
Caligo should work with all Linux-based operating systems. This program is tested partially on Windows and not officially tested on macOS, but there shouldn't be any problem if you install the correct dependencies.
Installation
Caligo uses MongoDB Atlas for it database, you can get it free at https://www.mongodb.com/ and save the uri for use on config or env variable.
Obviously you need git, and it should be already installed on major operating systems linux based.
Local
First, clone this Git repository locally: git clone https://github.com/adekmaulana/caligo
After that, you can run python3 -m pip install . to install the bot along with the depencies.
Once it's installed, you can choose to invoke it using the caligo command, or run the bot in-place (which is described later in the Usage section). Running it in-place is recommended to allow for automatic updates via Git.
Error: Directory '.' is not installable. File 'setup.py' not found.
This common error is caused by an outdated version of pip. We use the Poetry package manager to make things easier to maintain, which works with pip through PEP-517. This is a relatively new standard, so a newer version of pip is necessary to make it work.
Upgrade to pip 19 to fix this issue: pip3 install -U pip
Using Heroku
- Create a heroku account at http://signup.heroku.com/ (skip if you already have)
- Then go to your dashboard
- Create an empty application, remember your app name
- Go to Account Settings
- Find API Key and click Reveal, copy
- Fork this repo and then go to Settings Tabs on your forked repo
- Go to Secrets > New Repository Secret
- Create 2 of repository secret with this name:
- HEROKU_APP: Your created app name that upper step told
- HEROKU_API_KEY: Your API Key heroku that upper step told
- Then go to Actions Tab, Click Container
- Run workflow
- It should be finished around 5-6 minutes and then go to your heroku dashboard again, and choose the app you've created
- Go to Settings > Reveal Config Vars and fill the coresponding Name and Value based on
config.env_sample - After all Variables are met then you can run your dyno
Configuration
Copy config.env_sample to config.env and edit the settings as desired. Each and every setting is documented by the comments above it.
Obtain the API ID and API HASH from Telegram's website. TREAT THESE SECRETS LIKE A PASSWORD!
Obtain the DB_URI from MongoDB. TREAT THIS SECRETS LIKE A PASSWORD!
Obtain the SESSION_STRING by running python3 session.py. TREAT THESE SECRETS LIKE A PASSWORD!
Configuration must be complete before starting the bot for the first time for it to work properly.
Usage
To start the bot, type python3 main.py or python3 -m caligo if you are running it in-place or use command corresponding to your chosen installation method above.
Support
Feel free to join the official support group on Telegram for help or general discussion regarding the bot. You may also open an issue on GitHub for bugs, suggestions, or anything else relevant to the project.