Contact Book

A lightweight, terminal-based contact manager written in Python. Store, search, and manage your contacts locally — no account, no cloud, no internet required.

---

Features

• Add contacts with name, email, and phone number
• View all saved contacts in a clean format
• Search contacts by name
• Delete contacts with confirmation prompt
• Data stored locally as a human-readable JSON file

---

Demo

----- Contact Book -----
1. Add contact
2. View contacts
3. Search contact
4. Delete contact
5. Exit

Choice: 1
Name: John Doe
Email: john@example.com
Phone: 9876543210
Contact 'John Doe' saved.

Choice: 2

  John Doe
    Email : john@example.com
    Phone : 9876543210

---

Installation

Requirements: Python 3.8+ (no external libraries needed)

# 1. Clone the repository
git clone https://github.com/YOUR_USERNAME/contact-book.git
cd contact-book

# 2. Run
python contacts.py

No pip install needed — this project uses only Python's standard library.

---

Usage

Option	Action
1 Add	Save a new contact
2 View	List all contacts
3 Search	Find a contact by name
4 Delete	Remove a contact with confirmation
5 Exit	Quit the app

---

Project Structure

contact-book/
├── contacts.py      # Main application
├── .gitignore       # Excludes contacts.json and temp files
└── README.md

contacts.json is created locally when you first add a contact and is excluded from version control via .gitignore. This keeps your personal data private.

---

Planned Improvements

• Edit existing contact details
• Search by email or phone number
• Export contacts to CSV
• Duplicate contact detection

---

Tech Stack

• Language: Python 3
• Libraries: json, os (standard library only)
• Storage: Local JSON file

---

License

MIT License — free to use, fork, and modify.

---

Built as a personal project to practise Python fundamentals and CLI application design.