A secure, offline command-line password management application built with Python.
Designed for memorable password generation, local credential storage, and simple password lifecycle management.
Python Password Generator CLI is a terminal-based password management application developed using Python. The project focuses on generating memorable yet complex passwords while providing users with a simple local system for managing stored credentials.
The application allows users to create secure passwords from three personally chosen memorable words. These words are combined through different ordering patterns and enhanced with random numbers, special characters, and application-specific identifiers to create unique password variations.
Unlike cloud-based password managers, this project follows a fully local-first approach. All generated credentials are stored inside a local JSON file, meaning no user information is transmitted externally. The system was intentionally designed to reinforce understanding of file handling, JSON persistence, data manipulation, and command-line application structure.
The application provides complete password lifecycle management, allowing users to generate, view, update, and delete stored credentials directly from the terminal.
This project was created to explore practical concepts involved in building a small-scale credential management system.
The main learning objectives included:
- JSON Persistence: Understanding how Python applications store, retrieve, and modify structured data using JSON files.
- File Management: Learning how applications maintain local state across multiple executions.
- Password Generation Logic: Creating algorithms that combine user input with randomised values to produce unique outputs.
- CRUD Operations: Implementing create, read, update, and delete functionality for stored records.
- CLI Application Design: Building an interactive terminal workflow using menus and user prompts.
- Generate secure passwords using three memorable words.
- Create up to 480 unique password combinations from a single set of words.
-
Automatically include:
- Random numerical values.
- Special characters.
- Application or website names.
- Store credentials locally using JSON persistence.
- View all saved passwords in a readable format.
- Update existing password records.
- Delete unwanted credentials.
- Change memorable words to generate new password combinations.
- Operate completely offline.
User Input
|
↓
Three Memorable Words
|
↓
Combination Generator
|
↓
Random Number + Symbol
|
↓
Generated Password
|
↓
JSON Storage
The application follows a simple workflow:
- User provides three memorable words.
- The program generates multiple word arrangements.
- Additional random characters are added.
- The generated password is linked to an application or website.
- The final record is stored locally.
Python-Password-Generator/ │ ├── password_generator.py # Main CLI application logic ├── passwords.json # Local credential storage file ├── Preview.png # Application screenshot ├── README.md # Project documentation └── LICENSE # MIT License
- Ensure Python 3.13 is installed on your system.
-
Clone the repository:
git clone https://github.com/Sheikh-H/Password-Generator.git
-
Navigate into the project directory:
cd Password-Generator
-
Run the application:
python password_generator.py
- Follow the terminal prompts to configure your memorable words and begin managing passwords.
When launched, the application provides an interactive menu system:
1. Generate Password 2. View All Passwords 3. Change Memorable Words 4. Update Password 5. Delete Password 6. Exit
The password generation algorithm combines multiple data sources to create memorable but complex passwords.
Each generated password contains:
- Three user-defined memorable words.
- A random number between 0-9.
-
A randomly selected special character:
!, @, #, $, %, ^, &, *
- The target application or website name.
Application: Twitter Username: user@example.com Notes: Personal account Generated Password: AppleSkyRiver4@Twitter
All password information is stored locally inside passwords.json.
Example structure:
[
{
"application": "Twitter",
"username": "user@example.com",
"password": "AppleSkyRiver4@Twitter",
"notes": "Personal account"
}
]
The application loads this data when required, modifies the in-memory structure, and saves the updated information back into the JSON file.
Responsible for:
- Generating word combinations.
- Adding random characters.
- Creating unique password variations.
Handles:
- Creating the storage file.
- Reading saved credentials.
- Writing updated records.
- Maintaining stored information.
Provides:
- Interactive menu navigation.
- User prompts.
- Password management controls.
- Error handling.
This project is designed as a learning application and should not be considered a production password manager.
Current limitations:
- Passwords are stored as plain text.
- No encryption layer is currently implemented.
- No master password authentication exists.
- No secure key management system is included.
Future versions could introduce encryption and stronger security mechanisms.
- Add encryption for stored credentials.
- Implement unique IDs for easier password management.
- Add password strength scoring.
- Create secure master password authentication.
- Build a graphical user interface.
- Add automatic password copying to clipboard.
- Introduce SQLite database storage.
- Python Runtime: Python 3.13
-
Standard Libraries Used:
json, random, itertools, os - External Dependencies: None
This project is licensed under the MIT Licence — see the LICENCE file for details.
MIT Licence Copyright (c) 2026 Sheikh Hussain Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
🗣️ Feel free to follow, connect, and chat!
