Skip to content

Rohan-R07/LocalAssistant

Repository files navigation

🧠 Python Desktop Assistant & Utility Suite

A beginner-friendly Python desktop assistant project built using Tkinter, Turtle, Speech Recognition, and core Python modules.
This project bundles multiple small utilities (calculator, games, file tools, converters) into a single assistant-style experience.

⚠️ Note: This project was originally created as a learning project and later revisited. Some parts reflect early Python experimentation.


✨ Features

🗣️ Command-Based Assistant

  • Text-based assistant that responds to user commands
  • Uses pyttsx3 for text-to-speech
  • Modular design (each feature is a separate Python file)

🎨 Drawing Pad (Turtle + Tkinter)

  • GUI remote controller for Turtle
  • Buttons to move forward, backward, left, right
  • Clear, reset, hide pen, and help options
  • Built using Tkinter + Turtle

🧮 Utilities Included

  • 📏 CM to CM Converter
  • 🎲 Dice Simulator
  • 📅 Leap Year Checker
  • 🗂️ File Open / Write Tool
  • 📝 Simple Notepad App (Tkinter)

🖥️ System Tools Launcher

  • Open:
    • Command Prompt
    • Calculator
    • Browser (path configurable)
    • VS Code (path configurable)
    • Arduino IDE (path configurable)

📂 Project Structure

LocalAssistant/
├── main_assistant_frontend.py      # Main assistant entry point
├── opening_a_file_backend.py       # Backend logic for assistant actions
├── game_for_assistant.py           # Turtle drawing pad game
├── note_pad.py                     # Tkinter-based notepad
├── open_a_file.py                  # File read/write utility
├── cm_to_cm.py                     # CM converter
├── finding_leap_year.py            # Leap year checker
├── dice.py                         # Dice simulator
└── README.md


🛠️ Technologies Used

  • Python 3
  • Tkinter (GUI)
  • Turtle (graphics)
  • pyttsx3 (text-to-speech)
  • speech_recognition (voice input – optional)
  • subprocess (system commands)

⚙️ Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/Rohan-R07/LocalAssistant.git
cd LocalAssistant

📚 Libraries Used

🔹 Built-in Python Libraries

These come pre-installed with Python:

  • tkinter – GUI development
  • turtle – Graphics & drawing
  • subprocess – System command execution
  • random – Random number generation
  • os – File & system operations
  • time – Time-based operations

🔹 External Python Libraries

These need to be installed manually:

  • pyttsx3 – Text-to-speech
  • speech_recognition – Voice recognition

📦 Install Required Libraries

Use the following command to install external libraries:

python -m pip install pyttsx3 SpeechRecognition

⚠️ For microphone-based voice recognition, PyAudio is required. Windows users may need to install PyAudio using a .whl file.

⚙️ Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/Rohan-R07/LocalAssistant.git
cd LocalAssistant

python main_assistant_frontend.py

🧩 Customization Required

Some system-launching features require manual path configuration.

Edit the following lines inside opening_a_file_backend.py:

subprocess.call("put/your/vs code/path/here")
subprocess.call("put/your/chrome/path/here")

Replace them with the actual executable paths installed on your system.



👨‍💻 Author

Rohan R
Engineering Student | Python & Android Developer

  • Passionate about building beginner-friendly desktop applications
  • Interested in AI, automation, and software development
  • Actively learning and experimenting with Python and modern technologies

This project represents my early learning journey in Python and desktop application development.


🧾 Project Status

  • ✔️ Functional and stable for learning purposes
  • 🚧 Not optimized for production or enterprise use
  • 🧠 Designed to explore GUI development, automation, and modular programming

📌 Wrap-Up

This project demonstrates how multiple small Python programs can be combined into a single assistant-style application.
It highlights foundational concepts such as GUI development, modular code structure, and basic desktop automation.

While the design reflects a learning-stage implementation, the project serves as a solid base for:

  • Refactoring into modern architectures
  • Adding AI-powered features
  • Expanding into a full desktop assistant

📜 License

This project is open-source and free to use for learning, experimentation, and educational purposes.

Feel free to fork, modify, and improve the project.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages