or
THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS, COPYRIGHT HOLDERS, OR CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
THE AUTHOR DOES NOT TAKE RESPONSIBILITY FOR ANY ACTIONS PERFORMED BY THIRD PARTIES USING THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ILLEGAL, UNETHICAL, OR UNINTENDED USE CASES.
THE USER IS SOLELY RESPONSIBLE FOR ENSURING COMPLIANCE WITH ALL APPLICABLE LAWS, REGULATIONS, AND POLICIES WHEN USING, MODIFYING, OR DISTRIBUTING THIS SOFTWARE.
This bot does not use this code and has its own unique code that does not use osu cookies (to protect your account, I recommend using mirrors)
Telegram bot for osu!droid and osu! — generate profile cards, calculate PP/DPP, show top plays, beatmap info, replay analysis, and visual graphs. Invite AltPippiBot to your chat to fetch player stats, compare users, and create shareable profile images and charts.
Bot link: https://t.me/AltPippiBot (t.me/@AltPippiBot)
You can follow bot updates directly in Telegram (https://t.me/larizkaosudroid/541)
- Python 3.11+
- Install dependencies:
pip install -r requirements.txtCopy the example env and fill values locally (do NOT commit .env):
cp .env.example .env
# then edit .envRequired environment variables (examples are in .env.example):
BOT_TOKEN— Telegram bot tokenAPI_BASE— backend API base URL used by the botAPI_ID,API_HASH— Telegram API credentialsOSU_API_KEY,OSU_CLIENT_ID,OSU_CLIENT_SECRET— osu! API credentialsDROID_TOKEN— optional (leaderboard API)
Start the bot with:
python bot.pyUse screen/tmux or a process manager (systemd, pm2, supervisor) for production deployments.
For a full list of commands and usage examples, see COMMANDS.md.
Quick examples:
/bind Lift— link your osu!droid account/map <url>— get beatmap info/pp #osu/<id>— calculate PP/topplays— view your top plays/prpic Lift— generate profile card/ppgraph Lift— plot PP history/compare Lift Cookiezi— compare players
Run the test-suite locally:
pytest -q- Do not commit
.envor any secret files. Use GitHub Secrets for CI and environment variables on hosting services. - After removing secrets from history, rotate keys immediately.
- Make the repository private if you don't want public visibility.
PRs are welcome. Please add tests for new features and keep changes small and focused.
This project is dual-licensed under:
- MIT (see LICENSE)
- Apache License 2.0 (optional alternative)
You may use, modify, and distribute this software under the terms of either license.
All questions or support to here DEV CHANNEL