Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/silveirinhajuan/rotinapy

RotinaPy: Simplify your daily life and maximize productivity with an integrated app for task management, study tracking, flashcards, and more. Built with Streamlit and Python.
https://github.com/silveirinhajuan/rotinapy

data-analysis flashcards llm-integration llm-ui machine-learning ollama productivity python streamlit study study-project study-tracker task-management task-manager

Last synced: about 1 month ago
JSON representation

RotinaPy: Simplify your daily life and maximize productivity with an integrated app for task management, study tracking, flashcards, and more. Built with Streamlit and Python.

Awesome Lists containing this project

README

        

# ๐Ÿ“† RotinaPy
![Python Version](https://img.shields.io/badge/Python-3.12-blue?logo=python&logoColor=white) ![License](https://img.shields.io/badge/License-MIT-green) ![Contributions](https://img.shields.io/badge/Contributions-Welcome-orange) ![Status](https://img.shields.io/badge/Status-In_Progress-yellow)

RotinaPy is an application developed with Streamlit to assist in personal organization and the management of daily routines, study monitoring, flashcards, and more. This project is an evolution of [๐Ÿคบ LUX](https://www.github.com/silveirinhajuan/LUX), with improved features and planned future integration with it.

## โœจ Features

- **๐Ÿ—“๏ธ Daily Routines**: View and organize your daily tasks according to the days of the week.
- **๐Ÿค– Chat with LLMs**: Use language models running locally with Ollama.
- **๐Ÿ“Š Study Metrics**: Monitor your academic progress and analyze your performance.
- **๐Ÿ“š Flashcards**: Efficiently review content.
- **๐Ÿงฎ Formula Management**: Integrate formulas for quick and direct study.
- **โœ… TO-DO List**: Manage your tasks with a simple and effective list.

## ๐Ÿ“‚ Project Structure

```
|-csvs
| -domingo.csv
| -quarta.csv
| -quinta.csv
| -segunda.csv
| -sexta.csv
| -sรกbado.csv
| -terรงa.csv
|-pages
| -Chat.py
| -Estudos.py
| -Flashcards.py
| -Fรณrmulas.py
| -Tarefas.py
|.gitignore
|LICENSE
|README.md
|Rotina.py
|estudos_tracker.db
|formulas.csv
|pomodoro_tracking.csv
|requirements.txt
|style.css
|tarefas.txt
|utils.py
```

## ๐Ÿ› ๏ธ Installation

1. Clone the repository:

```bash
$ git clone https://github.com/silveirinhajuan/RotinaPy.git
```

2. Navigate to the project directory:

```bash
$ cd RotinaPy
```

3. Create a virtual environment and activate it:

```bash
$ python -m venv venv
$ source venv/bin/activate # Linux/MacOS
$ venv\Scripts\activate # Windows
```

4. Install the dependencies:

```bash
$ pip install -r requirements.txt
```

5. **Ensure Ollama is installed** and that at least one model is downloaded on your machine. For more information, visit [Ollama's official website](https://ollama.ai/).

6. Run the application:

```bash
$ streamlit run Rotina.py
```

## ๐Ÿงฉ Dependencies

The project's dependencies are listed in the `requirements.txt` file:

- `ollama==0.4.1`
- `pandas==2.0.3`
- `plotly==5.24.1`
- `streamlit==1.40.0`

## ๐ŸŽฅ Demo Video

You can find a demonstration of the project in the following file:

https://github.com/user-attachments/assets/dca8382d-5387-4404-b6ce-655a63bac277

## ๐Ÿ“ Acknowledgments

Part of the Flashcards page code was inspired by the [Flashcard repository](https://github.com/raman-r-4978/flashcard/tree/main?tab=readme-ov-file) by **raman-r-4978**. Many thanks for sharing your work!

## ๐Ÿค Contributing

Contributions are welcome! Feel free to open issues and submit pull requests.

## ๐Ÿ“œ License

This project is licensed under the [MIT](./LICENSE) license.

---

Developed with โค๏ธ by Juan Guerra.