Turbiling commited on
Commit
3f1fbff
·
verified ·
1 Parent(s): eea49fd

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +17 -2
README.md CHANGED
@@ -1,38 +1,53 @@
 
1
  title: Curriculum Assistantemoji: 📚colorFrom: bluecolorTo: greensdk: gradiosdk_version: 4.31.0python_version: 3.10
2
  Curriculum Assistant / نصابی اسسٹنٹ
3
  A web app for K-12 teachers to create lesson plans, flashcards, and worksheets based on curriculum PDFs with Student Learning Outcomes (SLOs). It supports the BOPPPS and Backward Design models, offers multilingual (English/Urdu) support, and generates downloadable Microsoft Word (.docx) files. Built using Python, Gradio, and Hugging Face models.
4
  How to Use / استعمال کا طریقہ
 
5
  Upload PDF / پی ڈی ایف اپ لوڈ کریں: Upload a Grade 1–12 curriculum PDF containing SLOs (e.g., “Grade 6 Science: Students will understand the basic cell structure”).
6
  Fill Form / فارم پُر کریں: Select grade (1–12), subject (Math, Science, etc.), topic (e.g., Photosynthesis), specific SLO (optional), and lesson duration (30, 45, or 60 minutes).
7
  Choose Output / آؤٹ پٹ منتخب کریں: Pick Lesson Plan (BOPPPS or Backward Design), Flashcards, or Worksheet.
8
  Generate / بنائیں: Click the “Generate” button to create your content.
9
  Download / ڈاؤن لوڈ کریں: Download the output as a Microsoft Word (.docx) file.
 
10
  Sample Query / نمونہ سوال
 
11
  “Generate a Grade 6 Math worksheet on fractions / گریڈ 6 ریاضی کی ورک شیٹ بنائیں جو کسر پر ہو۔”
12
  “Create a Grade 4 English BOPPPS lesson plan on nouns / گریڈ 4 انگریزی کا BOPPPS سبق پلان بنائیں جو اسم پر ہو۔”
 
13
  Setup Instructions / ترتیب دینے کے ہدایات
 
14
  Create a Space / اسپیس بنائیں:
15
  Go to Hugging Face Spaces.
16
  Click “Create new Space.”
17
  Select Gradio as the SDK, choose Public or Private, and pick Free CPU hardware.
 
 
18
  Upload Files / فائلیں اپ لوڈ کریں:
19
  Upload app.py, requirements.txt, README.md, and sample_curriculum.txt via the Files tab.
 
 
20
  Set Secrets / راز ترتیب دیں:
21
  In Space Settings, add HF_TOKEN (your Hugging Face access token) under Repository Secrets.
22
  Optionally, add GROK_API_KEY if using the Grok API (not required for this app).
 
 
23
  Build and Test / بنائیں اور ٹیسٹ کریں:
24
  Hugging Face will build the app automatically after uploading files.
25
  Check Logs for errors (e.g., missing dependencies).
26
  Access the app at https://<your-username>-<space-name>.hf.space.
 
 
 
27
  Troubleshooting / مسائل کا حل
 
28
  Configuration Error / ترتیب کی خرابی: Ensure the YAML in README.md includes sdk: gradio, sdk_version: 4.31.0, and python_version: 3.10.
29
  No Text in PDF / پی ڈی ایف میں متن نہیں: Ensure the PDF has text or is not corrupted. For scanned PDFs, the app uses OCR (requires Tesseract).
30
  Library Errors / لائبریری کی خرابیاں: Verify all dependencies are listed in requirements.txt.
31
  Token Issues / ٹوکن کے مسائل: Ensure HF_TOKEN is valid and set in Secrets.
32
  Build Fails / بنانے میں ناکامی: Check Logs for details and ensure app.py and requirements.txt are correct.
 
33
  Feedback / رائے
34
  Use the feedback box in the app to report issues or suggest improvements / ایپ میں فیڈبیک باکس استعمال کریں تاکہ مسائل کی اطلاع دیں یا بہتری کے لیے تجاویز دیں۔
35
  Built with ❤️ by xAI
36
 
37
-
38
-
 
1
+
2
  title: Curriculum Assistantemoji: 📚colorFrom: bluecolorTo: greensdk: gradiosdk_version: 4.31.0python_version: 3.10
3
  Curriculum Assistant / نصابی اسسٹنٹ
4
  A web app for K-12 teachers to create lesson plans, flashcards, and worksheets based on curriculum PDFs with Student Learning Outcomes (SLOs). It supports the BOPPPS and Backward Design models, offers multilingual (English/Urdu) support, and generates downloadable Microsoft Word (.docx) files. Built using Python, Gradio, and Hugging Face models.
5
  How to Use / استعمال کا طریقہ
6
+
7
  Upload PDF / پی ڈی ایف اپ لوڈ کریں: Upload a Grade 1–12 curriculum PDF containing SLOs (e.g., “Grade 6 Science: Students will understand the basic cell structure”).
8
  Fill Form / فارم پُر کریں: Select grade (1–12), subject (Math, Science, etc.), topic (e.g., Photosynthesis), specific SLO (optional), and lesson duration (30, 45, or 60 minutes).
9
  Choose Output / آؤٹ پٹ منتخب کریں: Pick Lesson Plan (BOPPPS or Backward Design), Flashcards, or Worksheet.
10
  Generate / بنائیں: Click the “Generate” button to create your content.
11
  Download / ڈاؤن لوڈ کریں: Download the output as a Microsoft Word (.docx) file.
12
+
13
  Sample Query / نمونہ سوال
14
+
15
  “Generate a Grade 6 Math worksheet on fractions / گریڈ 6 ریاضی کی ورک شیٹ بنائیں جو کسر پر ہو۔”
16
  “Create a Grade 4 English BOPPPS lesson plan on nouns / گریڈ 4 انگریزی کا BOPPPS سبق پلان بنائیں جو اسم پر ہو۔”
17
+
18
  Setup Instructions / ترتیب دینے کے ہدایات
19
+
20
  Create a Space / اسپیس بنائیں:
21
  Go to Hugging Face Spaces.
22
  Click “Create new Space.”
23
  Select Gradio as the SDK, choose Public or Private, and pick Free CPU hardware.
24
+
25
+
26
  Upload Files / فائلیں اپ لوڈ کریں:
27
  Upload app.py, requirements.txt, README.md, and sample_curriculum.txt via the Files tab.
28
+
29
+
30
  Set Secrets / راز ترتیب دیں:
31
  In Space Settings, add HF_TOKEN (your Hugging Face access token) under Repository Secrets.
32
  Optionally, add GROK_API_KEY if using the Grok API (not required for this app).
33
+
34
+
35
  Build and Test / بنائیں اور ٹیسٹ کریں:
36
  Hugging Face will build the app automatically after uploading files.
37
  Check Logs for errors (e.g., missing dependencies).
38
  Access the app at https://<your-username>-<space-name>.hf.space.
39
+
40
+
41
+
42
  Troubleshooting / مسائل کا حل
43
+
44
  Configuration Error / ترتیب کی خرابی: Ensure the YAML in README.md includes sdk: gradio, sdk_version: 4.31.0, and python_version: 3.10.
45
  No Text in PDF / پی ڈی ایف میں متن نہیں: Ensure the PDF has text or is not corrupted. For scanned PDFs, the app uses OCR (requires Tesseract).
46
  Library Errors / لائبریری کی خرابیاں: Verify all dependencies are listed in requirements.txt.
47
  Token Issues / ٹوکن کے مسائل: Ensure HF_TOKEN is valid and set in Secrets.
48
  Build Fails / بنانے میں ناکامی: Check Logs for details and ensure app.py and requirements.txt are correct.
49
+
50
  Feedback / رائے
51
  Use the feedback box in the app to report issues or suggest improvements / ایپ میں فیڈبیک باکس استعمال کریں تاکہ مسائل کی اطلاع دیں یا بہتری کے لیے تجاویز دیں۔
52
  Built with ❤️ by xAI
53