Shads229 commited on
Commit
bdaf967
·
1 Parent(s): 5d59419

Fix PaddlePaddle compatibility - use version 2.6.2

Browse files
Files changed (2) hide show
  1. .claude/settings.local.json +7 -0
  2. DEPLOYMENT.md +118 -0
.claude/settings.local.json ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Bash(curl -X POST \"https://shads229-ocr-minerva.hf.space/extract\" -F \"file=@Calculator_Anatomy.pdf\" -F \"lang=en\" --max-time 120)"
5
+ ]
6
+ }
7
+ }
DEPLOYMENT.md ADDED
@@ -0,0 +1,118 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Guide de déploiement sur Hugging Face Spaces
2
+
3
+ ## 📦 Étapes de déploiement
4
+
5
+ ### 1. Créer un compte Hugging Face
6
+ - Va sur https://huggingface.co/join
7
+ - Crée ton compte gratuitement
8
+
9
+ ### 2. Créer un nouveau Space
10
+ - Va sur https://huggingface.co/new-space
11
+ - Remplis les informations:
12
+ - **Space name**: `ocr-api` (ou le nom que tu veux)
13
+ - **License**: Apache 2.0
14
+ - **Select the Space SDK**: Docker
15
+ - **Space hardware**: CPU basic (gratuit)
16
+ - **Visibility**: Public
17
+
18
+ ### 3. Uploader les fichiers
19
+ Tu as deux options:
20
+
21
+ #### Option A: Via l'interface web
22
+ 1. Clique sur "Files" dans ton Space
23
+ 2. Upload ces fichiers un par un:
24
+ - `app.py`
25
+ - `requirements.txt`
26
+ - `Dockerfile`
27
+ - `README.md`
28
+ - `.gitignore`
29
+
30
+ #### Option B: Via Git (recommandé)
31
+ ```bash
32
+ # Clone ton space
33
+ git clone https://huggingface.co/spaces/TON-USERNAME/ocr-api
34
+ cd ocr-api
35
+
36
+ # Copie tous les fichiers du dossier OCR
37
+ cp /path/to/OCR/* .
38
+
39
+ # Commit et push
40
+ git add .
41
+ git commit -m "Initial commit - OCR API"
42
+ git push
43
+ ```
44
+
45
+ ### 4. Attendre le build
46
+ - Le Space va automatiquement builder (5-10 minutes)
47
+ - Tu verras les logs en temps réel
48
+ - Quand c'est prêt, tu verras "Running"
49
+
50
+ ### 5. Tester l'API
51
+ Ton API sera disponible à:
52
+ ```
53
+ https://TON-USERNAME-ocr-api.hf.space
54
+ ```
55
+
56
+ Test rapide:
57
+ ```bash
58
+ curl https://TON-USERNAME-ocr-api.hf.space/health
59
+ ```
60
+
61
+ ## 🧪 Tester localement (optionnel)
62
+
63
+ Si tu veux tester avant de déployer:
64
+
65
+ ```bash
66
+ cd C:\Users\shadr\Downloads\OCR
67
+
68
+ # Installer les dépendances
69
+ pip install -r requirements.txt
70
+
71
+ # Lancer l'API
72
+ uvicorn app:app --reload
73
+
74
+ # Tester
75
+ curl -X POST "http://localhost:8000/extract" -F "file=@test.pdf"
76
+ ```
77
+
78
+ ## 📝 Exemple d'utilisation après déploiement
79
+
80
+ ```python
81
+ import requests
82
+
83
+ # Remplace par ton URL
84
+ url = "https://TON-USERNAME-ocr-api.hf.space/extract"
85
+
86
+ # Envoyer un fichier
87
+ with open("document.pdf", "rb") as f:
88
+ files = {"file": f}
89
+ data = {"lang": "fr"}
90
+ response = requests.post(url, files=files, data=data)
91
+
92
+ print(response.json()["text"])
93
+ ```
94
+
95
+ ## ⚠️ Limites du plan gratuit
96
+
97
+ - CPU basic (pas de GPU)
98
+ - Peut être lent si beaucoup d'utilisateurs
99
+ - Le Space peut s'endormir après inactivité (redémarre au premier appel)
100
+
101
+ ## 🚀 Améliorer les performances (optionnel)
102
+
103
+ Si tu veux plus de vitesse:
104
+ 1. Va dans Settings de ton Space
105
+ 2. Change le hardware vers "CPU upgrade" ou "GPU" (payant)
106
+
107
+ ## 🔧 Debugging
108
+
109
+ Si le Space ne démarre pas:
110
+ 1. Vérifie les logs dans l'onglet "Logs"
111
+ 2. Assure-toi que tous les fichiers sont bien uploadés
112
+ 3. Vérifie que le Dockerfile est correct
113
+
114
+ ## 📞 Support
115
+
116
+ Si tu as des problèmes:
117
+ - Hugging Face Discord: https://hf.co/join/discord
118
+ - Forum: https://discuss.huggingface.co/