GoBot is a simple CLI automation script that logs in to your GoVault account (or creates one), a password manager app I built with the MERN stack + Next.js. It generates a secure password, and saves it, complete with labels and notes—directly from your terminal.
GoVault is a secure password management app I built using the MERN stack (MongoDB, Express, React, Node.js) with a Next.js frontend.
It allows users to generate strong passwords, store them with labels and notes, and access them across devices.
This CLI bot is built to automate GoVault from your terminal, especially useful for developers or power users.
➡️ Check out the GoVault source code
Managing dozens of logins can be tedious and insecure.
GoBot automates the routine: it interfaces with your GoVault password store, so you can generate and save strong passwords without leaving your terminal.
- 🚀 Quick Login/Create: Automatically logs in or provisions a new account
- 🔐 Password Generation: Create compliant passwords or accept your own
- 🏷️ Labels & Notes: Annotate each password entry
- 📋 Clipboard Copy: One‑click copy to clipboard
- ✨ CLI Spinner: Smooth, informative progress feedback
- Python 3.8+
- Google Chrome (latest recommended)
- ChromeDriver matching your Chrome version (in your PATH)
-
Clone the repo
git clone https://github.com/AmarMuric04/govault-bot.git cd gobot
-
Install dependencies
pip install -r requirements.txt
-
Configure environment
cp .env.example .env # Edit .env and set: # [email protected] # GOVAULT_PASSWORD=YourStrongPass!123
Tip: If your password doesn’t meet complexity, the bot can generate one for you.
-
Run the bot
python main.py
- Login or Create
The bot checks your credentials and auto‑creates an account if needed. - Password Prompt
Choose to supply your own compliant password or generate one. - Label & Notes
Provide a service label (e.g. “GitHub”) and optional notes. - Save & Copy
Wait ~10–15 seconds for the entry to save, then your password is in your clipboard!
Prompt | Enter Custom Password | Bot Generates One |
---|---|---|
Add Service Info | Spinner While Saving | Done! |
---|---|---|
- ChromeDriver Mismatch
Ensure your ChromeDriver version matches Google Chrome:chromedriver --version google-chrome --version
- Permission Errors
On *nix, you may need to make ChromeDriver executable:chmod +x $(which chromedriver)
- Network Timeouts
If login hangs, check your connection and retry after a few seconds.
Contributions are welcome! Please:
- Fork the repo
- Create a feature branch:
git checkout -b feature/YourFeature
- Commit changes:
git commit -m "feat: add …"
- Push:
git push origin feature/YourFeature
- Open a Pull Request
Please see CONTRIBUTING.md and CODE_OF_CONDUCT.md for details.
Here’s a breakdown of the main dependencies used in this project:
- 🕸️ selenium - Used to automate the browser and interact with the GoVault website (e.g., clicking buttons, filling forms, extracting data).
- 🌱 python-dotenv - Loads environment variables (like email and password) from a .env file for secure configuration.
- 📋 pyperclip- Used for copying the generated password to the clipboard.
This project is licensed under the MIT License.
See the LICENSE file for details.