{"id":44857725,"url":"https://github.com/code-society-lab/grace","last_synced_at":"2026-02-17T08:01:27.242Z","repository":{"id":37123919,"uuid":"372953729","full_name":"Code-Society-Lab/grace","owner":"Code-Society-Lab","description":"The official Code Society Discord bot","archived":false,"fork":false,"pushed_at":"2025-11-15T22:32:54.000Z","size":1002,"stargazers_count":19,"open_issues_count":18,"forks_count":14,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-11-16T00:20:22.916Z","etag":null,"topics":["discord","discord-bot","fun","learning","learning-by-doing","open-source","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Code-Society-Lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"license.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-06-01T20:28:50.000Z","updated_at":"2025-10-26T22:12:49.000Z","dependencies_parsed_at":"2023-12-27T01:23:34.325Z","dependency_job_id":"df46a325-466f-4e3e-9a8a-b82752a19937","html_url":"https://github.com/Code-Society-Lab/grace","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Code-Society-Lab/grace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Society-Lab%2Fgrace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Society-Lab%2Fgrace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Society-Lab%2Fgrace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Society-Lab%2Fgrace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Code-Society-Lab","download_url":"https://codeload.github.com/Code-Society-Lab/grace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Society-Lab%2Fgrace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29537238,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T05:00:25.817Z","status":"ssl_error","status_checked_at":"2026-02-17T04:57:16.126Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["discord","discord-bot","fun","learning","learning-by-doing","open-source","python","python3"],"created_at":"2026-02-17T08:00:55.925Z","updated_at":"2026-02-17T08:01:27.178Z","avatar_url":"https://github.com/Code-Society-Lab.png","language":"Python","readme":"\n# Grace\n[![Join on Discord](https://discordapp.com/api/guilds/823178343943897088/widget.png?style=shield)](https://discord.gg/code-society-823178343943897088)\n[![Grace tests](https://github.com/Code-Society-Lab/grace/actions/workflows/grace.yml/badge.svg?branch=main)](https://github.com/Code-Society-Lab/grace/actions/workflows/grace.yml)\n[![Last Updated](https://img.shields.io/github/last-commit/code-society-lab/grace.svg)](https://github.com/code-society-lab/grace/commits/main)\n\nGrace is the official Code Society discord bot. The goal is to give our members the opportunity to participate in the\ndevelopment of the server's bot and contribute to a team project while also improving it.\n\n---\n\n## Installation\nInstalling Grace is fairly simple. You can do it in three short step.\n\n0. [Install Python and dependencies](#0-install-python-and-dependencies)\n1. [Set up your app and token](#1-set-up-your-app-and-token)\n2. [Start the bot](#2-start-the-bot)\n\n### 0. Python and Dependencies\nInstall [Python](https://www.python.org/downloads/). Python 3.10 or higher is required.\n\n\u003e [!NOTE]\n\u003e We highly recommend that you set up a virtual environment to work on Grace.\n\u003e https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/\n\nIn the `grace` directory, open a terminal (Linus/MacOS) or cmd (Windows) and execute `pip install -e .` \n(recommended for development) or `pip install .`. \n\n### 1. Set up your App and Token\nIf you did not already do it, [create](https://discord.com/developers/docs/getting-started#creating-an-app) your Discord \nbot. Then, create a file called `.env` in the project directory, open it and add \n`DISCORD_TOKEN=\u003cYour token\u003e`. (Replace \u003cYour token\u003e by your discord token).\n\n\u003e [!CAUTION]\n\u003e Do not share that file nor the information inside with anyone.\n\n### 2. Run the Bot\nThe last part is to execute the bot. Execute `grace run` to run Grace in development mode. The rest\nof the installation should complete itself and start the bot.\n\n\u003e [!NOTE]\n\u003e If the grace command is unrecognized, be sure that you installed the bot properly.\n\n## Script Usage\n- **Bot Command(s)**:\n  - `grace run` : Starts the bot (`ctrl+c` to stop)\n- **Database Command(s)**:\n    - `grace db create` : Creates the database\n    - `grace db drop`   : Deletes the database\n    - `grace db up`     : Upgrade to latest migration\n    - `grace db down`   : Downgrade to previous migration\n    - `grace db seed`   : Seeds the tables\n\nRun `grace --help` for more information.\n---\n\n## Advance configurations\nFor advance configurations, visit the [wiki](https://github.com/Code-Society-Lab/grace/wiki)\n\n## Contribution\nAs mentioned in the description, we invite everyone to participate in the development of the bot. You can contribute to the project by simply opening an issue, by improving some current features or even by adding your own features.\nBefore contributing please refer to our [contribution guidelines](https://github.com/Code-Society-Lab/grace/blob/main/docs/CONTRIBUTING.md) and [Code of Conduct for contributor (temporary unavailable)](#).\n\n---\n\n## Troubleshooting\nIf you're getting unexpected result, visit the wiki's [troubleshooting](https://github.com/Code-Society-Lab/grace/wiki/Troubleshooting)\npage. For any other problems or questions ask us on our [discord  server](https://discord.gg/code-society-823178343943897088).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-society-lab%2Fgrace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-society-lab%2Fgrace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-society-lab%2Fgrace/lists"}