{"id":20462022,"url":"https://github.com/denvercoder1/hogwarts-ghosts","last_synced_at":"2025-06-11T09:06:16.069Z","repository":{"id":37986295,"uuid":"499323123","full_name":"DenverCoder1/hogwarts-ghosts","owner":"DenverCoder1","description":"Bot for the Hogwarts Ghosts Discord server with features for ticket channels and archiving","archived":false,"fork":false,"pushed_at":"2023-08-01T04:54:45.000Z","size":57568,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-16T00:40:16.834Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DenverCoder1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-02T23:41:32.000Z","updated_at":"2024-11-11T01:44:43.000Z","dependencies_parsed_at":"2024-11-15T12:39:50.116Z","dependency_job_id":null,"html_url":"https://github.com/DenverCoder1/hogwarts-ghosts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fhogwarts-ghosts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fhogwarts-ghosts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fhogwarts-ghosts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fhogwarts-ghosts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DenverCoder1","download_url":"https://codeload.github.com/DenverCoder1/hogwarts-ghosts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242018932,"owners_count":20058704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T12:29:36.940Z","updated_at":"2025-03-05T11:32:23.062Z","avatar_url":"https://github.com/DenverCoder1.png","language":"Python","readme":"# Hogwarts Ghost Bot\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nHogwarts Ghost Bot is a bot for allowing users to create confessional channels in the Hogwarts Ghost Discord server.\n\nThis bot is a fork of [bot-be-named](https://github.com/kevslinger/bot-be-named) to make use of its archiving features.\n\n## How to install your own instance\n\n### Prerequisites\n\n- [python3.8 or newer](https://realpython.com/installing-python/)\n- [Git](https://github.com/git-guides/install-git)\n- [Pip package installer for Python](https://phoenixnap.com/kb/install-pip-windows)\n\nOne of:\n- [Heroku CLI client for hosting](https://medium.com/analytics-vidhya/how-to-install-heroku-cli-in-windows-pc-e3cf9750b4ae)\n- [Flyctl for hosting](https://jonahlawrence.hashnode.dev/hosting-a-python-discord-bot-for-free-with-flyio)\n\nNote that you may use another Python installer (instead of Pip), Host (instead of Heroku/Fly.io) but that will require you figuring out the required setup and configuration changes yourself.\n\n### Installation\n\nWe recommend using [virtual environments](https://docs.python.org/3/tutorial/venv.html) to manage python packages for our repo. To clone the repo and install dependencies, run the following on the Command Line\n\n```bash\n#Clone the bot locally\ngit clone https://github.com/DenverCoderOne/hogwarts-ghosts.git\ncd hogwarts-ghosts\nvirtualenv .venv\n# Activate the virtual environment\nsource .venv/bin/activate # Linux\nsource .venv\\Scripts\\activate # Windows\n#This installs all the python dependancies the bot needs\npip install -r requirements.txt \u0026\u0026 pre-commit install\n```\n\nTo run the bot locally, you will need a `.env` file which is used by [python-dotenv](https://github.com/theskumar/python-dotenv) to load `ENV` variables. Copy `.env.template` into `.env` with  \n\n```bash\ncp .env.template .env\n```\n\nand fill in the blanks in order to get the bot running.\n\nOnce you do all that, run\n\n\n```bash\nsource venv/bin/activate\npython bot.py\n```\n\nand the bot will run on the supplied discord token's account.\n\n### Hosting\n\nOnce you have the bot running and basic commands (like `~help`) run properly, you can host it externally. Our instance of the bot is [hosted on Heroku](https://medium.com/@linda0511ny/create-host-a-discord-bot-with-heroku-in-5-min-5cb0830d0ff2)\n\n\n### Other useful things\n\nIf you have github + heroku, using Heroku's [Github integration](https://devcenter.heroku.com/articles/github-integration) allows you to automatically push Github pushes to also deploy on Heroku. (Using `git push` to push to both Github and Heroku)\n\nWhen deploying on heroku, any variables stored in .env locally cannot be pushed to any public repos. It's advisable to use [Heroku Config Vars](https://devcenter.heroku.com/articles/config-vars) to store them.\n\n## Current Modules\n\n- [Archive](./modules/archive) for downloading channel/category/server contents into a Zip file\n- [Channel Management](./modules/channel_management) for cloning, creating, and moving channels - [Cipher Race](modules/cipher_race) Race against the clock decoding ciphers!\n- [Confessional Request](./modules/confessional_request) for allowing users to create temporary channels in a category\n- [Custom Command](./modules/custom_command) for making custom commands in different servers\n- [Discord](modules/discord) for discord utility commands (e.g. roles, stats)\n- [Error Logging](./modules/error_logging) for printing error logs\n- [Help](./modules/help) is an updated help command which automatically pulls docstrings for `~help`\n- [Lookup](./modules/lookup) for Searching the internet via google and wikipedia\n- [Misc](./modules/misc) for misc. random (fun) commands\n- [Music Race](./modules/music_race/) Help! Our tunes have been sawed apart and put back incorrectly!\n- [Perfect Pitch](./modules/perfect_pitch) Become a composer and write tunes in mp4\n- [Role Management](./modules/role_management) for managing roles and similar\n\nNote: the main purpose of this bot is for Confessional Requests and Archiving.\n\nThe other features have not been tested in this bot and may not work as expected.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenvercoder1%2Fhogwarts-ghosts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdenvercoder1%2Fhogwarts-ghosts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenvercoder1%2Fhogwarts-ghosts/lists"}