--- title: README emoji: 🐠 colorFrom: green colorTo: red sdk: static pinned: false ---
Talvo Logo # 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)
--- ## 📖 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
| 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 |
--- ## 🤝 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
| Channel | Details | |---------|---------| | 📧 **Email** | [support@talvo.com](mailto:support@talvo.com) | | 🌐 **Website** | [talvo.com](https://talvo.com) | | 🐙 **GitHub** | [github.com/talvoapp](https://github.com/talvoapp) |
--- ## 📄 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** ---
**Made with ❤️ in Egypt 🇪🇬** ⭐ If you like the project, don't forget to give it a star! [⬆ Back to Top](#talvo-desktop)