Skip to content

Repository files navigation

EasyLife 🛡️⚡️

Secure, Multi-User Personal Management System

EasyLife is a robust, Dockerized personal vault designed to manage your most sensitive credentials and notes with high security and privacy.


🚀 Key Features

  • Isolated Private Vaults: Multiple users can register and manage their own independent, encrypted data. 🛡️
  • Safety Lock: Passwords stay 10px blurred and require a one-click password challenge to reveal. 🔐
  • Selective Reveal: Only re-blurs individual fields after 15 seconds. 💨
  • Master Grace Period: One verification unlocks your session for 15 minutes. 🛡️⚡️
  • Safe Deletion: High-stakes deletions require manual text-match confirmation. 🛡️
  • Robust Excel Ingestion: A namespace-agnostic parser to import data from complex Excel spreadsheets. 📊

🛠 Getting Started

1. Clone the Repository

git clone https://github.com/malaybiswal/easyLife.git
cd easyLife

2. Configure Environment

Create a .env file based on the .env.example provided:

cp .env.example .env
  • Update DJANGO_SECRET_KEY, DB_PASSWORD, and DB_HOST.
  • Generate a Fernet encryption key for ENCRYPTION_KEY.

3. Start the Containers

# Mac (Modern Docker)
docker compose up -d --build

# Linux (Legacy Docker Compose)
docker-compose up -d --build

4. Initialize Database Schema

Run the following after the containers are active to create your vault tables:

# Mac
docker compose exec web python manage.py migrate

# Linux
docker-compose exec web python manage.py migrate

5. Create Your Account

Set up your primary account:

# Mac
docker compose exec web python manage.py createsuperuser

# Linux
docker-compose exec web python manage.py createsuperuser

6. Ingest Excel Data (Optional)

To import your credentials from an Excel file (e.g., personal.xlsx):

# Mac
docker compose exec web python manage.py parse_credentials personal.xlsx --user <YOUR_USERNAME>

# Linux
docker-compose exec web python manage.py parse_credentials personal.xlsx --user <YOUR_USERNAME>

🧪 Security & Testing

EasyLife includes a 13-point Security Audit Suite to ensure 100% data isolation and encryption integrity.

Run the Suite

# Mac
docker compose exec web python manage.py test credentials

# Linux
docker-compose exec web python manage.py test credentials
  • Fast-Track Mode: Tests automatically use a local SQLite database to ensure blazing-fast performance. ⚡️

🗄 Database & Infrastructure

  • MySQL DB: Runs inside a container on port 3306 (exposed as 3307 locally).
  • Web App: Listens on http://localhost:8010.
  • Auto-Restart: Containers start automatically after a computer reboot.

📊 Future Roadmap 🎯

  1. Password Generator: Built-in tool to create strong, random passwords.
  2. Expense Module Re-design: A refined parser for the "Spending" tabs with full CRUD visualization.
  3. File Management: Secure indexing and metadata storage for scanned documents.
  4. Two-Factor Authentication (2FA): Extra security for every vault.

🛡️ Data Privacy 🔑

This repository is sanitized—secrets (.env), raw logs (processed.txt, error.txt), and Excel data are ignored via .gitignore and .dockerignore. 🛡️

About

private stuff management service

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages