Skip to content

PosFlow AI adalah solusi otomasi cerdas yang menggabungkan kekuatan Artificial Intelligence (Gemini 2.5 Flash) untuk menyederhanakan proses administrasi struk POS Indonesia. Alat ini mampu mengekstrak nomor billing secara otomatis dari foto nota, scan gambar, atau file PDF, kemudian mengunduh struk aslinya secara massal.

License

Notifications You must be signed in to change notification settings

FebraS/PosFlowAI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ PosFlow AI: Automated POS Indonesia Billing Extractor

Python Gemini AI

PosFlow AI adalah solusi otomasi cerdas yang menggabungkan kekuatan Artificial Intelligence (Gemini 2.5 Flash) untuk menyederhanakan proses administrasi struk POS Indonesia. Alat ini mampu mengekstrak nomor billing secara otomatis dari foto nota, scan gambar, atau file PDF, kemudian mengunduh struk aslinya secara massal.


✨ Fitur Unggulan

  • 🧠 Intelligent OCR: Menggunakan Gemini 2.5 Flash untuk membaca kode billing dari foto yang miring, buram, atau dokumen hasil scan yang kompleks.
  • ⚑ Batch Processing: Memproses ratusan file dalam satu folder sekaligus tanpa intervensi manual.
  • πŸ”— Auto-Generator URL: Mengonversi kode billing dan tanggal menjadi token Base64 yang valid untuk akses langsung ke server POS Indonesia.
  • πŸ“‚ Auto-Organization: Hasil unduhan PDF disimpan secara rapi di folder output yang ditentukan.
  • 🎨 Terminal UI: Antarmuka CLI yang informatif dengan progress tracker dan desain ASCII art yang estetik.

πŸ“‹ Alur Kerja Sistem

  1. Scanning: Skrip memindai folder input untuk mencari file gambar atau PDF.
  2. AI Inference: File dikirim ke model Gemini untuk diekstraksi nomor billing-nya saja.
  3. Encoding: Kode yang ditemukan digabungkan dengan parameter tanggal dan dienkripsi ke format Base64.
  4. Download: Skrip melakukan request ke server POS Indonesia dan mengunduh file PDF resmi.

πŸ› οΈ Instalasi

  1. Clone Repositori

    git clone [https://github.com/FebraS/PosFlowAI.git](https://github.com/FebraS/PosFlowAI.git)
    cd PosFlowAI
  2. Instal Dependensi

    pip install -r requirements.txt
  3. Konfigurasi API Key Buka file posflow.py dan masukkan API Key Gemini Anda pada variabel berikut:

    GENAI_API_KEY = "AIzaSy..." # Dapatkan di [https://aistudio.google.com/](https://aistudio.google.com/)

πŸš€ Panduan Penggunaan

Jalankan skrip melalui terminal atau command prompt dengan instruksi berikut:

Mode A: Ekstraksi AI (Dari Folder Gambar/PDF)

Gunakan mode ini jika Anda memiliki banyak foto nota fisik.

python posflow.py -r ./folder_nota -d 2026-05-20 -o hasil_unduh --ai

About

PosFlow AI adalah solusi otomasi cerdas yang menggabungkan kekuatan Artificial Intelligence (Gemini 2.5 Flash) untuk menyederhanakan proses administrasi struk POS Indonesia. Alat ini mampu mengekstrak nomor billing secara otomatis dari foto nota, scan gambar, atau file PDF, kemudian mengunduh struk aslinya secara massal.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages