README.md

---
title: README
emoji: 🐠
colorFrom: green
colorTo: red
sdk: static
pinned: false
---

<div align="center">

<img src="https://avatars.githubusercontent.com/u/337130551?s=200&v=4" alt="Talvo Logo" width="120" height="120" style="border-radius: 20px;">

# Talvo Desktop

### Medical Supplies & Pharmaceuticals Management System

A complete solution for managing sales, purchases, inventory, and customers — designed specifically for pharmacies and medical supply stores.

[![Website](https://img.shields.io/badge/Website-talvo.com-blue?style=for-the-badge)](https://talvo.com)
[![Version](https://img.shields.io/badge/Version-1.0.2-green?style=for-the-badge)](https://github.com/talvoapp/talvo-desktop/releases)
[![Platform](https://img.shields.io/badge/Platform-Windows-blue?style=for-the-badge&logo=windows)](https://github.com/talvoapp/talvo-desktop/releases)
[![License](https://img.shields.io/badge/License-Proprietary-red?style=for-the-badge)](LICENSE)

[Website](https://talvo.com) • [Download](https://github.com/talvoapp/talvo-desktop/releases) • [FAQ](https://talvo.com/faq) • [Contact Us](mailto:support@talvo.com)

</div>

---

## 📖 About the Project

**Talvo Desktop** is a complete management system designed specifically for pharmacies and medical supply stores. It provides everything you need to manage your business from one place, with full Arabic language support and a modern user interface.

### 🎯 The Problem It Solves

Pharmacies and medical supply stores struggle with:
- ❌ Scattered data across different systems
- ❌ Difficulty managing inventory and batches
- ❌ Inability to connect branches together
- ❌ Weak and inaccurate reports
- ❌ High costs of existing systems

### ✅ The Solution Talvo Provides

- ✅ **One system** for everything (sales, purchases, inventory, customers)
- ✅ **Complete inventory management** with batch tracking and expiration dates
- ✅ **Branch linking** remotely via Cloudflare Tunnel
- ✅ **Advanced reports** exportable to Excel and PDF
- ✅ **One-time payment** — no monthly subscriptions

---

## ✨ Features

### 💰 Sales Management
- Fast and easy sales invoices
- Sales returns
- Automatic customer discounts
- Professional invoice printing
- Invoice preview before printing

### 🛒 Purchases Management
- Purchase invoices from suppliers
- Purchase returns
- Advance purchase requests
- Supplier price comparison
- Supplier purchase history

### 📦 Inventory Management
- Real-time quantity tracking
- Batch management
- Expiration dates
- Shortage alerts
- Automatic shortage notebook

### 👥 Customers Management
- Comprehensive database
- Account statements
- Rewards and points system
- Discount tiers
- Customer profit reports

### 🏢 Branches Management
- Automatic branch linking
- Real-time data sync
- Access from anywhere
- Cloudflare Tunnel system
- Real-time branch status

### 📊 Advanced Reports
- Daily sales reports
- Profit reports
- Inventory reports
- Customer reports
- Excel and PDF export

### 🔐 Permissions System
- 222 detailed permissions
- 8 default roles
- Custom roles
- Activity log
- Password protection

### ☁️ Cloud Synchronization
- Automatic sync
- Backup every 60 minutes
- Fast restore
- Integrity verification
- Keeps last 2 backups

---

## 🚀 Quick Start

### 📋 Requirements

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| **Operating System** | Windows 7 SP1 | Windows 10/11 |
| **Memory** | 4 GB RAM | 8 GB RAM |
| **Storage** | 500 MB | 1 GB |
| **Display** | 1280×720 | 1920×1080 |
| **Internet** | Required for sync | Fast internet |

### 📦 Installation

1. **Download the installer:**
   [Talvo_Setup_1.0.2.exe](https://github.com/talvoapp/talvo-desktop/releases/latest)

2. **Run the file:**
   ```
   Talvo_Setup_1.0.2.exe
   ```

3. **Choose additional tasks:**
   - **For Master devices:** Select "Install Talvo Server Service" and "Install Cloudflare Tunnel Service"
   - **For Branch devices:** Don't select any service

4. **Run the application:**
   - **Master:** Enter `license_key` + `username` + `password`
   - **Branch:** Enter `branch_code` + `username` + `password`

---

## 💻 Technologies Used

<div align="center">

| Technology | Usage |
|------------|-------|
| ![Python](https://img.shields.io/badge/Python-3.8-blue?logo=python) | Core programming language |
| ![PyQt5](https://img.shields.io/badge/PyQt5-5.15-blue?logo=qt) | User interface |
| ![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask) | Local server |
| ![SQLAlchemy](https://img.shields.io/badge/SQLAlchemy-2.0-red?logo=sqlalchemy) | ORM |
| ![SQLite](https://img.shields.io/badge/SQLite-3-blue?logo=sqlite) | Local database |
| ![Cloudflare](https://img.shields.io/badge/Cloudflare-Tunnel-orange?logo=cloudflare) | Remote linking |
| ![Nuitka](https://img.shields.io/badge/Nuitka-2.7-yellow) | Compilation |

</div>

---

## 🤝 Contributing

We welcome your contributions! If you'd like to contribute:

1. **Fork the project**
2. **Create a new branch:**
   ```bash
   git checkout -b feature/AmazingFeature
   ```
3. **Commit your changes:**
   ```bash
   git commit -m 'Add some AmazingFeature'
   ```
4. **Push to the branch:**
   ```bash
   git push origin feature/AmazingFeature
   ```
5. **Open a Pull Request**

---

## 🐛 Reporting Issues

If you encounter any issue, please [open an Issue](https://github.com/talvoapp/talvo-desktop/issues/new/choose) and include:

- **Description of the issue**
- **Steps to reproduce**
- **Expected behavior**
- **Actual behavior**
- **Screenshots (if possible)**
- **Log files (if possible)**

---

## 📞 Contact

<div align="center">

| Channel | Details |
|---------|---------|
| 📧 **Email** | [support@talvo.com](mailto:support@talvo.com) |
| 🌐 **Website** | [talvo.com](https://talvo.com) |
| 🐙 **GitHub** | [github.com/talvoapp](https://github.com/talvoapp) |

</div>

---

## 📄 License

This project is **owned by Talvo**. All rights reserved © 2026.

**For commercial use, please contact us at [support@talvo.com](mailto:support@talvo.com).**

---

## 🙏 Special Thanks

Thanks to everyone who contributed to this project:

- **Development team**
- **Testers**
- **Customers who provided feedback**

---

<div align="center">

**Made with ❤️ in Egypt 🇪🇬**

⭐ If you like the project, don't forget to give it a star!

[⬆ Back to Top](#talvo-desktop)

</div>