The maintainer has not written a description at the source.
Demo bksha/python-study-bot, read from Hugging Face 1 min ago.
bksha/python-study-bot is a live demo on Hugging Face by bksha. It declares no license on Hugging Face. Public does not mean open source: without a license, nobody is granted the right to reuse it. It has 0 likes and last changed on 2026-10-15. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from Hugging Face on 2026-11-20.
The author's own card, shown from Hugging Face. Take My Repo does not keep a copy.
A Discord progress tracking bot tailored for a 5-person study group working through the 12-Hour "Python Full Course for Beginners" by Bro Code (77 lessons).
Built with Python 3.11+, discord.py 2.x, aiosqlite, and AST safe code parsing. Designed for Windows 11 with clean, modular architecture, explicit PowerShell workflows, and complete test coverage.
Each member learns at their own independent pace. Every lesson requires 2 ordered steps:
.py file and submit it as proof.The bot tracks everyone independently, enforces the sequential rules, provides interactive peer verification, and posts a personalized daily reminder showing each person their exact next step.
python sheet/
โโโ bot.py # Main Discord bot client, lifecycle hooks & error handlers
โโโ config.py # Environment configuration and task catalog loader
โโโ db.py # Asynchronous SQLite persistence layer (aiosqlite)
โโโ tasks.json # Full 77-lesson catalog with timestamps and project flags
โโโ seed_demo.py # Demo script seeding 5 members in varying states
โโโ requirements.txt # Python package dependencies
โโโ pytest.ini # Pytest configuration with asyncio mode enabled
โโโ .env.example # Configuration template
โโโ .gitignore # Ignores venv, .env, *.db, proofs/, and cache
โโโ cogs/
โ โโโ tracker.py # Slash commands: /join, /watched, /done, /next, /undo
โ โโโ leaderboard.py # Slash commands: /progress, /board
โ โโโ reminder.py # Daily reminder loop and /remind_now admin command
โโโ utils/
โ โโโ helpers.py # Progress bars, timestamp links, embed builders
โ โโโ validator.py # Safe AST syntax parser (zero code execution)
โ โโโ views.py # Interactive peer verification button ("Looks good")
โโโ proofs/ # Stored code proofs (.py files) submitted by members
โโโ tests/
โโโ test_progression.py # Enforced progression, next step & undo tests
โโโ test_status.py # Inactivity (24h, 48h+, 72h) & status tests
โโโ test_validator.py # AST safety, syntax error, and limit tests
python --version). Make sure "Add python.exe to PATH" was checked during Python installation.Open PowerShell and navigate to the project directory:
cd "c:\Users\Administrator\Desktop\learning\python sheet"
If you encounter execution of scripts is disabled on this system, allow script execution for the current session:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
# Create virtual environment
python -m venv venv
# Activate virtual environment
.\venv\Scripts\Activate.ps1
(When activated, your prompt will show (venv) at the beginning).
pip install -r requirements.txt
To obtain your bot credentials:
Python Study Bot), and click Create..env file (DISCORD_TOKEN).botapplications.commandsSend MessagesEmbed LinksAttach FilesRead Message HistoryUse Slash CommandsGUILD_ID in .env).CHANNEL_ID in .env)..env)Copy .env.example to .env:
Copy-Item .env.example .env
notepad .env
Fill in your actual values:
# Discord Bot Authentication Token
DISCORD_TOKEN=your_actual_bot_token_here
# Target Server and Channel IDs
GUILD_ID=123456789012345678
CHANNEL_ID=123456789012345678
# Daily Reminder Schedule (IANA Timezone Name)
TIMEZONE=UTC
REMINDER_HOUR=9
# Bro Code Course Video Link
VIDEO_URL=https://www.youtube.com/watch?v=XKHEz65m27w
# Member Capacity
MAX_MEMBERS=5
Pro-Tip on
GUILD_ID: ProvidingGUILD_IDsynchronizes slash commands to your server instantly on startup! If left empty, global slash commands take up to 1 hour for Discord's CDN to propagate.
Run the full automated test suite (15 tests covering progression state machine, status thresholds, and AST safety):
pytest -v
All 15 tests will execute and pass:
test_member_registration_and_limittest_sequential_progression_rulestest_independent_pace_me_at_5_friend_at_4test_undo_functionalitytest_peer_verificationtest_status_on_track_recent_activitytest_status_behind_24_to_72_hourstest_status_inactive_over_48_hourstest_finished_statustest_valid_python_syntaxtest_syntax_error_detection_without_executiontest_non_execution_guaranteetest_reject_non_python_extensiontest_reject_empty_filetest_reject_oversized_fileTo preview how /board, /progress, and /remind_now look with 5 realistic members without waiting days for real activity:
python seed_demo.py
This creates:
ON_TRACK).ON_TRACK).BEHIND).INACTIVE 48h+).NEW).Start the bot:
python bot.py
Console output will display:
==========================================================
Python Study Group Discord Bot (Windows 11 / Python 3.11+)
==========================================================
[2026-10-15 00:20:00] [INFO] StudyGroupBot: Initializing SQLite database tables...
[2026-10-15 00:20:01] [INFO] StudyGroupBot: Loaded cog extension: cogs.tracker
[2026-10-15 00:20:01] [INFO] StudyGroupBot: Loaded cog extension: cogs.leaderboard
[2026-10-15 00:20:01] [INFO] StudyGroupBot: Loaded cog extension: cogs.reminder
[2026-10-15 00:20:02] [INFO] StudyGroupBot: Instantly synced 8 slash commands to Guild ID: ...
[2026-10-15 00:20:03] [INFO] StudyGroupBot: Bot connected as Python Study Bot#1234
| Command | Arguments | Who Can Use | Description |
|---|---|---|---|
/join |
None | Everyone | Registers you in the study group (max 5 members). |
/watched |
task: 1-77 |
Registered | Marks the video lesson as watched. Prerequisite: previous task must be DONE. |
/done |
task: 1-77, file: .py |
Registered | Submits your Python code proof. Validates AST syntax; triggers peer review card. |
/next |
None | Registered | Displays your personal next step with a timestamped YouTube link (?t=seconds). |
/progress |
None | Registered | Displays your personal progress bar, stats, and verified count. |
/board |
None | Everyone | Leaderboard of all 5 members with progress bars, next tasks, and โญ badges. |
/undo |
task: 1-77 |
Registered | Safely undoes your latest action (only your own entries). |
/remind_now |
None | Administrator | Triggers the daily reminder message immediately for testing. |
When a member runs /done:
.py.ast.parse): Validates Python syntax tree without ever executing the code. Any syntax error immediately returns line number and error message.Every day at REMINDER_HOUR in TIMEZONE, the bot posts one message containing:
@mention, activity badge, personal next step, lesson title, and timestamped video link.๐ข On Track: Active in the last 24h.๐ก Behind: No activity in the last 24h, but active in the last 72h.๐ด Inactive (48h+): Zero progress in 48+ hours. Includes playful callout:"@Diana you didn't do anything except send a message, where's your task?" (Chat messages do NOT reset activity; only
/watchedand/donecount).
๐ Finished: Completed all 77 course tasks!reminder_state table to ensure restarts never duplicate daily reminders.PythonStudyDiscordBotpowershell.exe-NoExit -ExecutionPolicy Bypass -File "C:\Users\Administrator\Desktop\learning\python sheet\run_bot.ps1"C:\Users\Administrator\Desktop\learning\python sheet\Create run_bot.ps1:
Set-Location "C:\Users\Administrator\Desktop\learning\python sheet"
.\venv\Scripts\Activate.ps1
python bot.py
Download NSSM and run:
nssm install PythonDiscordBot "C:\Users\Administrator\Desktop\learning\python sheet\venv\Scripts\python.exe" "C:\Users\Administrator\Desktop\learning\python sheet\bot.py"
nssm start PythonDiscordBot
Because the bot uses SQLite and standard Python, it can also run continuously on free/cheap hosting like Railway, Fly.io, or an Oracle Free Tier VM.
bksha/python-study-bot is a live demo on Hugging Face by bksha. Its maker has not written a description.
It declares no license on Hugging Face. Public does not mean open source: without a license, nobody is granted the right to reuse it.
No. It is a live demo that runs in the browser on Hugging Face.
Its last change on Hugging Face was on 2026-10-15. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.