Authipy

A secure, offline Two-Factor Authentication (2FA) desktop application.

Features • Installation • Usage • Contributing

Features

• 🔒 Secure TOTP code generation
• 💾 Local-only storage
• 📱 QR code import/export
• 🗑️ Recycle bin feature
• 📋 One-click copying
• ⚡ Modern Qt interface

Installation

Method 1: Windows Executable (Recommended)

1. Download the latest Authipy.exe from Releases
2. Run directly - No installation required

Method 2: PyPI Package

pip install authipy
authipy  # to run

Method 3: Build from Source

1. Clone the repository:

git clone https://github.com/TanmoyTheBoT/authipy.git
cd authipy

2. Create and activate virtual environment (recommended):

python -m venv venv
venv\\Scripts\\activate   # Windows

3. Install dependencies:

pip install -r requirements.txt

4. Install in development mode:

pip install -e .

5. Run the application:

authipy

6. Build executable (optional):

# Install PyInstaller
pip install pyinstaller Pillow sip

# Build single-file executable
pyinstaller --clean --noconsole --onefile --icon=docs/images/test.jpg --name Authipy src/authipy/main.py

The executable will be created in the dist directory.

Usage

Add New Account

1. Click "Add Account"
2. Enter:
   • Service name (required)
   • Secret key (required)
   • Issuer name (optional)

Generate Codes

• Select account from list
• Code displays automatically
• Click code to copy

Manage Accounts

• Right-click for options
• Use recycle bin
• Import/Export accounts

Data Location

• Windows: %USERPROFILE%\.config\authipy
• Offline storage only

Contributing

1. Fork the repository
2. Install dev dependencies:

pip install -r requirements-dev.txt

3. Make changes
4. Run tests:

pytest
pytest --cov=src --cov-report=html  # coverage report

5. Submit Pull Request

Support

• Report Issues
• GitHub Repository

License

MIT License