https://github.com/henrymorgandibie/compliance-bot
Automates regulatory and tax filing workflows with real-time Slack alerts, GPT-powered explanations, and a visual Streamlit dashboard for compliance teams.
https://github.com/henrymorgandibie/compliance-bot
automation gpt python slack streamlit
Last synced: about 2 months ago
JSON representation
Automates regulatory and tax filing workflows with real-time Slack alerts, GPT-powered explanations, and a visual Streamlit dashboard for compliance teams.
- Host: GitHub
- URL: https://github.com/henrymorgandibie/compliance-bot
- Owner: HenryMorganDibie
- Created: 2025-07-11T02:35:35.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-11T02:42:20.000Z (12 months ago)
- Last Synced: 2025-07-11T07:13:55.489Z (12 months ago)
- Topics: automation, gpt, python, slack, streamlit
- Language: Python
- Homepage:
- Size: 179 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📅 Smart Compliance Filing Tracker
A workflow automation tool that helps financial service companies **track legal, regulatory, and tax obligations** — with **GPT-powered explanations**, **Slack deadline alerts**, and a **streamlit UI** for real-time visibility.
![alt text]()
![alt text]()
---
## 🚀 Features
✅ Visual filing tracker (built in Streamlit)
✅ Filing urgency status (Overdue / Due Today / etc.)
✅ Daily automated checks for upcoming deadlines
✅ Slack alerts for due/overdue filings
✅ GPT-powered filing explainer
✅ Export to CSV
✅ Easily extendable for email alerts, multi-user workflows, or database support
---
## 🏗️ Project Structure
compliance-tracker/
│
├── app/ # Streamlit UI
│ └── main.py
│
├── workflows/ # Automation logic
│ └── scheduler.py
│
├── notifications/ # Slack integration
│ └── slack_bot.py
│
├── data/
│ └── filing_schedule.json # Filing records (editable)
│
├── run_daily.py # Runs daily checks at 09:00 AM
├── requirements.txt
├── .env # Slack webhook (not committed)
├── README.md
└── .gitignore
---
## 📦 Installation
### 1. Clone this repo
```bash
git clone https://github.com/your-username/compliance-tracker.git
cd compliance-tracker
```
### 2. Create virtual environment & install requirements
```
python -m venv venv
venv\Scripts\activate # on Windows
# OR
source venv/bin/activate # on Mac/Linux
pip install -r requirements.txt
```
### 3. Create .env for Slack alerts
Create a .env file in the root folder:
```ini
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/your/webhook/url
### 💻 Usage
▶️ Launch the Streamlit App
```
streamlit run app/main.py
```
This opens a dashboard where you can:
- View all pending filings
- Mark filings as completed
- See urgency levels
- Trigger GPT-based explanation of filings
- Export all data to CSV
### ⏰ Run Deadline Alerts Manually
```
python workflows/scheduler.py
```
This checks all filings and sends Slack alerts if any are:
- Overdue
- Due today
- Due in 1–2 days
### 🕒 Run it Automatically Every Day
```
python run_daily.py
```
This runs scheduler.py every day at 09:00 AM using the schedule library.
### 📁 Sample Filing Entry (filing_schedule.json)
```json [ { "filing_name": "Q3 Tax Return", "filing_type": "Tax", "description": "Quarterly tax obligation for fintech operators", "due_date": "2025-07-12", "jurisdiction": "Nigeria", "business_type": "Microfinance", "escalation_contact": "compliance@yourcompany.com", "completed": false } ] ```
### 🤖 GPT Integration
You can use OpenAI’s GPT to auto-explain filings using ai/gpt_explainer.py.
If using GPT, you’ll also want to store your OpenAI key in .env like so:
```ini
OPENAI_API_KEY=your-openai-api-key
### ✅ Future Improvements
- Add user authentication
- Connect to a database (SQLite/PostgreSQL)
- Add email alerts via SendGrid or SMTP
- Build admin panel to add/edit filings in UI
- Integrate with calendar APIs (Google Calendar, Outlook)
### 👨💻 Author
Henry C. Dibie
Data & Automation Enthusiast