Common OwOMizu errors and how to fix them.
Last updated: 2026-07-15
broken data stream when reading image file
The auto-solver crashes with a Pillow error when trying to read the captcha image downloaded from Discord.
NoneType is not iterable (aiohttp)
Bot crashes on startup or during HTTP requests with 'NoneType is not iterable' traceback from inside aiohttp.
discord-protos fails to install on Python 3.13+
pip install fails with compilation errors when installing discord-protos on Python 3.13+ or Termux.
DeprecationWarning: asyncio.get_event_loop() on Python 3.12+
Warnings flood the console or the bot crashes with RuntimeError related to asyncio event loop on Python 3.12 or 3.13.
Cannot read properties of undefined (AutoEnhance dashboard)
The AutoEnhance section of the dashboard throws a JS error 'Cannot read properties of undefined (reading enabled)' and fails to load.
quick-toggle returns 400 Invalid command for army/mail/pup/piku
Toggling army, mail, pup, or piku from the dashboard returns HTTP 400 'Invalid command'.
Pillow install fails on Termux (libjpeg missing)
pip install pillow fails on Termux with 'libjpeg not found' or similar compilation error.
Cog file not found for enabled feature
Bot starts but a feature set to enabled: true in settings.json silently does nothing.
No tokens found! Check .env or tokens.txt
The bot prints 'No tokens found!' and exits immediately because TOKENS resolved to nothing.
Invalid token format passed to run_bot! must contain 2 dots
A token failed validation: empty, shorter than 50 characters, or missing the two dot separators every Discord token has.
[Termux] Critical Error: Invalid Token! / Improper Token / 401
The token reached Discord but was rejected at login with a 401 or 'Improper Token' error.
Failed to download captcha image / Web-Solver: Failed to launch browser
The auto-solver could not fetch the captcha PNG from Discord's CDN, or Selenium failed to start a browser for the hCaptcha web-solver path.
Solver Failed - Please solve manually!
The ONNX image solver ran but could not produce a confident answer, or the downloaded image was corrupt and decoding failed.
Channel ID <id> not found
The channel ID in .env or tokens.txt doesn't resolve to a real channel the bot can see.
Error installing dependencies / ModuleNotFoundError
pip install failed mid-way, or the bot imports a package that was never installed.
Broken pipe error detected. Restarting bot...
The websocket connection to Discord dropped mid-stream and the bot is auto-restarting.
Curl error / Unknown error when running bot
A low-level connection error that isn't a clean HTTP failure, raised during bot startup or gateway connect.
Database error / Could not backup db
The SQLite database (utils/data/db.sqlite) is locked, corrupted, or the schema version drifted after an update.
Failed to fetch <data> / Failed to fetch git data
The bot tried to fetch remote JSON (version check, news, updater) and the request timed out or the host was unreachable.
Quick check shows TOKENS as None / empty
The diagnostic shows TOKENS as None, confirming .env was not loaded into the process environment.