Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iam-mhaseeb/StandupMonkey
A self hosted slack bot to conduct standups & generate reports.
https://github.com/iam-mhaseeb/StandupMonkey
open-source opensource python python-3 python3 self-hosted slack slack-bot slackbot standup standup-bot standup-meetings standup-report standup-slackbot
Last synced: 3 months ago
JSON representation
A self hosted slack bot to conduct standups & generate reports.
- Host: GitHub
- URL: https://github.com/iam-mhaseeb/StandupMonkey
- Owner: iam-mhaseeb
- License: gpl-3.0
- Archived: true
- Created: 2021-05-31T17:40:46.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-07-26T01:53:42.000Z (over 3 years ago)
- Last Synced: 2024-06-28T05:38:56.132Z (5 months ago)
- Topics: open-source, opensource, python, python-3, python3, self-hosted, slack, slack-bot, slackbot, standup, standup-bot, standup-meetings, standup-report, standup-slackbot
- Language: Python
- Homepage: https://standup-monkey.herokuapp.com/slack/install
- Size: 48.8 KB
- Stars: 72
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
StandupMonkey
A self hosted slack bot to conduct standups & generate reports.
Report Bug
ยท
Request Feature
![Contributors](https://img.shields.io/github/contributors/iam-mhaseeb/StandupMonkey)
![Issues](https://img.shields.io/github/issues-raw/iam-mhaseeb/StandupMonkey)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
![Forks](https://img.shields.io/github/forks/iam-mhaseeb/StandupMonkey?style=social)
![Stars](https://img.shields.io/github/stars/iam-mhaseeb/StandupMonkey?style=social)Installation
-----------
1. Install already hosted bot (**Use this for only testing purpose**)2. Deploy on your own server (**Recommended**)
1. Clone this repoistory and deploy on server of your choice
2. Go to https://api.slack.com/apps
4. Select **Create New App**
5. Choose **From an app manifest**
6. Select your workspace
7. Copy yaml from [here](https://github.com/iam-mhaseeb/StandupMonkey/blob/main/manifest/app.yml) paste it in a code editor
8. Replace https://standup-monkey.herokuapp.com with your server base url (example: https://yourwebsite.com)
9. Paste it in opened modal and click next
10. Click create and app will be created in your workspace
11. Go to manage your app screen & select **Basic Information**
12. Setup your postgres database on your desired service
13. Navigate to **App Credentials** section
14. Set the following enviornment variables:
* **Client ID as SLACK_CLIENT_ID**
* **Client Secret as SLACK_CLIENT_SECRET**
* **Signing Secret as SIGNING_SECRET**
* **Slack bot token as SLACK_BOT_TOKEN** Yes, we need it really :( files upload doesn't work without it.
* **Database host as HOST**
* **Database user as USER**
* **Database password as PASSWORD**
15. Add your newly added bot to your required channel
16. You standup bot is now ready to use ๐
Quick start
-----------
1. Go to **StandupMonkey** messages
2. Type **/standup**
![image](https://user-images.githubusercontent.com/15142776/123472160-3ca1f580-d610-11eb-9f1e-16e12e2c4897.png)
3. Fill details in the input boxes and press enter to submit each input
![image](https://user-images.githubusercontent.com/15142776/123472383-88549f00-d610-11eb-9e7c-fa3e176330c5.png)
**Note: Make sure StandupMonkey is added to the channel in which you are trying to post your standup status**
4. StanupMonkey will post submitted standup status to selected channel automatically
![image](https://user-images.githubusercontent.com/15142776/123472559-c0f47880-d610-11eb-8d95-ef60c3f709e5.png)
5. Type **/generate-report @user start_date end_date** to generate CSV report of standup statuses of a user
![image](https://user-images.githubusercontent.com/15142776/126823317-c14ba478-4870-49b7-bd01-7a660e3135e5.png)
**Note:** Start date & date should be in the format: **YYYY-MM-DD**
6. Your generated report will be something like this
![image](https://user-images.githubusercontent.com/15142776/126823561-ef3cd486-0ab5-4a00-9904-c9bb9a07e74c.png)## Authors
* **Muhammad Haseeb** - *Initial work* - [Muhammad Haseeb](https://github.com/iam-mhaseeb)
## Licensing
The project is [GPL-3.0 License](LICENSE).