Skip to content

README.md

Latest commit

 

History

History
184 lines (122 loc) · 4.71 KB

README.md

File metadata and controls

184 lines (122 loc) · 4.71 KB

🧠 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.