🇷🇺 Russian README

NotPX Bot ⬛

Automated script for NotPixel with painting on canvas using a template, passing proof-of-humanity checks and more

Requirements

Features

Feature	Supported
SuperMegaCool Capybara intro	✅
Tournament update	✅
Passing proof-of-humanity checks	✅
NotPX API change detection	✅
Script in .exe	❌
Simple scripts for installation and uninstallation	✅
Proxy binding to session	✅
User-Agent binding to session	✅
Auto-detect new .session and register it in bot	✅
Auto-paiting	✅
Auto-tasks	✅
Auto-input of the secret words we know	✅
Auto-input of daily secret words	❌
Watching ads	✅
Auto-use bombs
Auto-claim PX	✅
Auto-upgrade boosters	✅
Night mode	✅
Async working	✅

Why are we better than the rest of the public scripts?

✨ Capybara Intro (game changer, killer feature)

🔍 Proof-of-Humanity checks

We use real task solutions for proof-of-humanity checks instead of random responses, so you don't get banned.

There is still a chance of being banned, but it we did everything possible to prevent it.

🎨 Auto-Painting

We don't use random coordinates to paint on the canvas.

Our script automatically paints on the canvas using a template using data received from the websocket connection. It means that you will receive a PX for each painting you make!

🌟 Simple scripts to install NotPixelBot and uninstall it

We provide simple scripts for easy installation and uninstallation of the NotPixelBot.

🔗 We have a clear use of ref system

If you change the ref id to your own in the settings, that's what it will be. Our script does not prevent you from doing this, unlike some public scripts.

🚀 Regular updates

We update NotPixelBot according to changes in NotPixel.

Settings

Settings	Description
API_ID / API_HASH	API credentials for Telegram API
PLAY_INTRO	True/False playing intro on script start (DON'T YOU DARE TO TURN THIS OFF)
INITIAL_START_DELAY_SECONDS	Delay range in seconds to use for a random delay when starting the session
ITERATION_SLEEP_MINUTES	How long the script will wait before starting the next iteration of the script (painting, claiming and e.t.c)
USE_REF	True/False the use of a referral to start the bot
REF_ID	Referral ID to be used
TOURNAMENT_TEMPLATE_ID	ID of the tournament template
SLEEP_AT_NIGHT	True/False sleep at night
NIGHT_START_HOURS	Start hours range of the night
NIGHT_END_HOURS	End hours range of the night
ADDITIONAL_NIGHT_SLEEP_MINUTES	Additional minutes range to sleep at night
ROUND_START_TIME_DELTA_MINUTES	Additional minutes after the start of the round
ROUND_END_TIME_DELTA_MINUTES	Additional minutes before the end of the round
CLAIM_PX	True/False auto-claim px
UPGRADE_BOOSTS	True/False auto-upgrade boosters
PAINT_PIXELS	True/False auto-painting
COMPLETE_TASKS	True/False auto-completing tasks
PARTICIPATE_IN_TOURNAMENT	True/False participate in tournament
COMPLETE_QUESTS	True/False auto-input of the secret words we know
COMPLETE_DANGER_TASKS	True/False auto-completing dangerous tasks
WATCH_ADS	True/False auto-watch ads

How to install 📚

Before you begin, make sure you have meet the requirements. It's really IMPORTANT, without these requiremenets, you can NOT install our script.

Obtaining API Keys

1. Go to my.telegram.org and log in using your phone number.
2. Select "API development tools" and fill out the form to register a new application.
3. Record the API_ID and API_HASH provided after registering your application in the .env file.

Sometimes when creating a new application, it may display an error. It is still not clear what causes this, but you can try the solutions described on stackoverflow.

Linux manual installation

git clone https://github.com/Dellenoam/NotPixelBot.git
cd NotPixelBot
python3 -m venv .venv
source .venv/bin/activate
pip install poetry
poetry install --only main
cp .env-example .env
nano .env  # Specify your API_ID and API_HASH, the rest is taken by default

Windows manual installation

git clone https://github.com/Dellenoam/NotPixelBot.git
cd NotPixelBot
python -m venv .venv
.venv\Scripts\activate
pip install poetry
poetry install --only main
copy .env-example .env
# Then open .env in any text editor and specify your API_ID and API_HASH, the rest is taken by default

Windows installation using powershell script

NOTE: The install.ps1 script installs Chocolatey, a package manager for Windows, and uses it to install Python, Git, and NodeJS, if they are not already installed

We have also created powershell script which allows you to easily install NotPixelBot on Windows.

Before running the script, you must do some preparation

Open powershell and enter there this command. This will allow you to run scripts without restrictions.

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

Ok, now we are ready. Execute following commands:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Dellenoam/NotPixelBot/refs/heads/master/windows_scripts/install.ps1" -OutFile "$env:TEMP\install.ps1"

powershell -ExecutionPolicy Bypass -File "$env:TEMP\install.ps1"

After that script will be downloaded to the temp folder and executed. When it asks you to enter path where to do git clone, just enter the path where you want to do git clone. For example C:\Users\username\Scripts\NotPixelBot without any quotes.

Navigate to the folder with the installed bot. Copy the .env-example file and rename it to .env, then open it in any editor and write down the API_ID and API_HASH that you received earlier.

Now you can proceed to the Run the script section.

Windows uninstallation using powershell script

NOTE: The install.ps1 script installs Chocolatey, which is then used to install Python, Git, and Node.js. This uninstall.ps1 script will also uninstall these programs using Chocolatey, including Chocolatey itself. However, it will not remove the NotPixelBot folder. Therefore, please be cautious.

If you want to uninstall NotPixelBot, run following commands:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Dellenoam/NotPixelBot/refs/heads/master/windows_scripts/uninstall.ps1" -OutFile "$env:TEMP\uninstall.ps1"

powershell -ExecutionPolicy Bypass -File "$env:TEMP\uninstall.ps1"

Run the script

Using start.bat

You can run the script using start.bat script, just execute it.

Manually

Before running the script, you ALWAYS need to activate the virtual environment and check for updates.

# Linux
source .venv\bin\activate
# Windows
.venv\Scripts\activate

# Linux/Windows
git pull

To run the script, use python3 main.py on Linux or python main.py on Windows.

Also, you can use flag --action or -a to quickly run the script with specified action.

# Linux
python3 main.py --action [1/2]
# Windows
python main.py --action [1/2]

# Or

# Linux
python3 main.py -a [1/2]
# Windows
python main.py -a [1/2]

Where [1/2] is:

1 - Creates a session
2 - Run bot

So for example if you want to create a session, you can run this command:

# Linux
python3 main.py --action 1
# Windows
python main.py --action 1

# Or

# Linux
python3 main.py -a 1
# Windows
python main.py -a 1

Contacts

If you have any questions or suggestions, please feel free to contact us in comments.