An automation tool for students and teachers
Organize tasks, reminders, and study files from one place, integrating with Notion and Google Drive.
Features β’ Installation β’ Usage β’ Configuration β’ Contributing
AutoClass Helper is a command-line tool designed to automate academic task management. It allows students and teachers to:
- π Manage tasks and reminders from Notion
- π Organize study files in Google Drive
- β° Schedule automatic reminders
- π Visualize pending task progress
- π Receive notifications for upcoming tasks
- β Notion Integration: Connect with your Notion database to manage tasks
- β Google Drive Integration: Access and organize study files
- β Reminder System: Schedule automatic notifications
- β Complete Logging: Record all executed actions
- β Friendly Interface: Interactive console menu with colors
- β Flexible Configuration: Use environment variables to customize
- Python 3.10+: Main language
- Notion API: For task and database management
- Google Drive API: For file management
- Schedule: For scheduled tasks
- Colorama: For colorful console interface
- Python-dotenv: For secure credential management
- Python 3.10 or higher
- Notion account (optional)
- Google account (optional)
- Clone the repository
git clone https://github.com/yourusername/autoclass-helper.git
cd autoclass-helper- Create a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate- Install dependencies
pip install -r requirements.txt- Configure environment variables
cp .env.example .envEdit the .env file with your credentials:
NOTION_API_KEY=your_notion_token
NOTION_DATABASE_ID=your_database_id
GOOGLE_DRIVE_FOLDER_ID=your_folder_idpython main.pyββββββββββββββββββββββββββββββββββββββββββ
β π AUTOCLASS HELPER v1.0 β
ββββββββββββββββββββββββββββββββββββββββββ
1. π View Notion tasks
2. π View Google Drive files
3. β Add new task
4. β° Configure reminders
5. π View statistics
6. π Sync all
7. β Exit
Choose an option:
- Go to Notion Developers
- Create a new integration
- Copy the integration token
- Share your database with the integration
- Copy the database ID
- Go to Google Cloud Console
- Create a new project
- Enable the Google Drive API
- Create OAuth 2.0 credentials
- Download the
credentials.jsonfile and place it in the project root
autoclass_helper/
βββ main.py # Main entry point
βββ modules/
β βββ __init__.py
β βββ notion_api.py # Notion API management
β βββ google_drive_api.py # Google Drive API management
β βββ scheduler.py # Reminder system
βββ data/ # Local data and cache
βββ utils/
β βββ __init__.py
β βββ helpers.py # Helper functions
βββ requirements.txt # Project dependencies
βββ .env.example # Environment variables template
βββ .gitignore # Files ignored by Git
βββ README.md # This file
from modules.notion_api import NotionAPI
notion = NotionAPI()
tasks = notion.get_pending_tasks()
for task in tasks:
print(f"- {task['title']} (Due: {task['due_date']})")from modules.scheduler import TaskScheduler
scheduler = TaskScheduler()
scheduler.add_reminder("09:00", "Review daily tasks")
scheduler.start()Contributions are welcome. For major changes:
- Fork the project
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License. See the LICENSE file for more details.
RubΓ©n GarcΓa
- GitHub: @yourusername
- LinkedIn: Your profile
- Notion for their excellent API
- Google for the Drive API
- The Python community for the libraries used
β If this project was useful to you, consider giving it a star β
Made with β€οΈ by RubΓ©n GarcΓa