prash616 commited on
Commit
c0752f1
ยท
verified ยท
1 Parent(s): 10629fd

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +77 -31
README.md CHANGED
@@ -21,50 +21,96 @@ tags:
21
  - agriculture
22
  ---
23
 
24
- # Indica-1.7B-GGUF ๐Ÿ‡ฎ๐Ÿ‡ณ
25
 
26
- **Indica-1.7B** is a lightweight, high-performance SLM (Small Language Model) specifically post-trained for the Indian context. Built upon the **Qwen3-1.7B** dense transformer architecture, this model has undergone a rigorous multi-stage alignment (fine-tuning for behavior and preference) process to excel in Hindi, Hinglish, and various regional dialects while maintaining strong CoT (Chain-of-Thought) reasoning capabilities.
27
 
28
- This repository provides the model in **GGUF** format, optimized for local inference (the process of generating text) on consumer hardware using tools like **Ollama**, **llama.cpp**, and **LM Studio**.
29
 
30
- ## ๐Ÿš€ Model Details
31
- - **Architecture:** 1.7 Billion parameters (the internal variables a neural network learns), utilizing a dense causal transformer design.
32
- - **Specialized Domains:** Tailored for Indian Law (IPC/BNS), Agriculture (MSP/PM-Kisan), and National Examinations (UPSC/JEE).
33
- - **Multilingual Mastery:** Fluent in Hindi-English code-switching (Hinglish) and supports multiple regional Indian languages.
34
- - **Thinking Paradigm:** Utilizes a native "thinking mode" via `<think>` tags for complex reasoning tasks before outputting a final answer.
35
- - **Context Length:** Supports up to 2048 tokens natively.
36
- - **Developer:** Prashant (prash616).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
37
 
38
- ## ๐Ÿ›  Training Pipeline
39
- The model was developed through a specialized four-stage alignment strategy:
40
 
41
- 1. **Foundational Pre-training:** Fine-tuned on Hindi Wikipedia (`wikimedia/wikipedia`) to establish deep linguistic roots and vocabulary density.
42
- 2. **Supervised Fine-Tuning (SFT):** Trained on high-quality instruction datasets (`ai4bharat/indic-instruct-data-v0.1`, `viber1/indian-law-dataset`) covering Indian law, agriculture, and everyday Hinglish conversations.
43
- 3. **GRPO (Group Relative Policy Optimization):** Aligned using Reinforcement Learning to reward logical reasoning and the use of internal thinking tags using GSM8K datasets.
44
- 4. **DPO (Direct Preference Optimization):** Final behavioral polish using `HuggingFaceH4/ultrafeedback_binarized` to ensure a helpful, polite, and culturally aware persona.
 
 
 
45
 
46
- ## ๐Ÿ“ฆ Quantization Details
47
- These GGUF files were created using `llama.cpp` through the Unsloth library. Quantization (the process of reducing the precision of the model's numbers) allows the model to run on machines with limited VRAM (Video Random Access Memory).
 
 
 
 
48
 
49
- | Filename | Bit-Size | File Size | Use Case |
50
- | :--- | :--- | :--- | :--- |
51
- | `Indica-1.7B-Q4_K_M.gguf` | 4-bit | ~1.1 GB | **Recommended.** Balanced quality and extreme speed. Ideal for standard laptops, MacBooks, and low-RAM devices. |
52
- | `Indica-1.7B-Q8_0.gguf` | 8-bit | ~1.8 GB | **Maximum Quality.** Retains near-perfect precision from the 16-bit model. Recommended for technical legal or mathematical queries. |
 
53
 
54
- ## ๐Ÿ’ป How to Use
 
 
 
55
 
56
- ### 1. With Ollama (Easiest)
57
- Ensure you have [Ollama](https://ollama.com/) installed, then run:
58
  ```bash
59
  ollama run hf.co/prash616/Indica-1.7B-GGUF
60
 
 
 
 
 
61
 
 
62
 
 
 
 
 
 
 
 
 
 
 
 
63
 
64
- ## 2. With LM Studio
65
- Download LM Studio.
66
- Search for prash616/Indica-1.7B-GGUF in the search bar.
67
- Download the Q4_K_M file and load it into the local server.
68
 
69
- ##3. Chat Template (For Developers)
70
- If you are writing custom Python inference scripts, the model uses the standard qwen-3 chat template. Ensure your system prompt is set correctly:
 
 
21
  - agriculture
22
  ---
23
 
24
+ # Indica-1.7B-GGUF: Post-Tuned for the Indian Context ๐Ÿ‡ฎ๐Ÿ‡ณ
25
 
26
+ **Indica-1.7B** is a lightweight, high-performance reasoning model specifically post-trained to navigate the linguistic and cultural nuances of India. Built on the **Qwen3-1.7B** architecture, this model utilizes a specialized four-stage alignment pipeline to excel in Hindi, Hinglish, and regional dialects while providing domain expertise in Indian law, agriculture, and education.
27
 
28
+ This repository provides optimized **GGUF** weights, enabling private, local inference on consumer-grade hardware via **Ollama**, **llama.cpp**, and **LM Studio**.
29
 
30
+ ---
31
+
32
+ ## ๐Ÿš€ Model Overview
33
+
34
+ * **Model Type:** Causal Language Model
35
+ * **Architecture:** Dense Transformer (Qwen3-1.7B base)
36
+ * **Parameters:** 1.7 Billion
37
+ * **Primary Languages:** Hindi, English, Hinglish
38
+ * **Secondary Languages:** Bengali, Tamil, Telugu, Marathi, Gujarati
39
+ * **Context Window:** 2048 tokens
40
+ * **Thinking Mode:** Native `<think>` tag support for Chain-of-Thought reasoning
41
+
42
+ ---
43
+
44
+ ## ๐Ÿ› ๏ธ Training Details
45
+
46
+ The model was developed through a rigorous multi-stage post-training regime designed to maximize factual groundedness and reasoning depth.
47
+
48
+ ### 1. Dataset Composition
49
+ The training utilized a diverse mix of specialized Indian datasets:
50
+
51
+ | Stage | Dataset | Purpose |
52
+ | :--- | :--- | :--- |
53
+ | **Pre-train** | `wikimedia/wikipedia` (Hindi) | Foundational linguistic and cultural grounding. |
54
+ | **SFT** | `ai4bharat/indic-instruct-data-v0.1` | Core instruction following in Indian languages. |
55
+ | **SFT** | `Abhishekcr448/Hinglish-Everyday-Conversations` | Mastery of urban code-switching (Hinglish). |
56
+ | **SFT** | `viber1/indian-law-dataset` | Expertise in IPC, CRPC, and the Constitution. |
57
+ | **GRPO** | `openai/gsm8k` | Reasoning and Chain-of-Thought (CoT) alignment. |
58
+ | **DPO** | `HuggingFaceH4/ultrafeedback_binarized` | Behavioral polish and preference alignment. |
59
 
60
+ ### 2. Hyper-parameters
61
+ The following parameters were utilized during the final alignment stages to ensure stability and reasoning quality:
62
 
63
+ #### **Stage 3: GRPO (Reinforcement Learning)**
64
+ * **Learning Rate:** 5e-6
65
+ * **Group Size (num_generations):** 6
66
+ * **Max Prompt Length:** 256 tokens
67
+ * **Max Completion Length:** 200 tokens
68
+ * **Optimizer:** AdamW (8-bit)
69
+ * **LR Scheduler:** Cosine
70
 
71
+ #### **Stage 4: DPO (Preference Alignment)**
72
+ * **Learning Rate:** 5e-5
73
+ * **Beta:** 0.1
74
+ * **Batch Size:** 1 per device
75
+ * **Gradient Accumulation:** 4
76
+ * **Max Length:** 1024 tokens
77
 
78
+ ---
79
+
80
+ ## ๐Ÿ“ฆ Quantization & Deployment
81
+
82
+ These GGUF files were exported via the Unsloth library using `llama.cpp`.
83
 
84
+ | Quant Method | File Size | Recommended For |
85
+ | :--- | :--- | :--- |
86
+ | **Q4_K_M** | ~1.1 GB | General use, mobile devices, and high-speed local inference. |
87
+ | **Q8_0** | ~1.8 GB | High-precision tasks requiring maximum accuracy. |
88
 
89
+ ### Local Inference with Ollama
 
90
  ```bash
91
  ollama run hf.co/prash616/Indica-1.7B-GGUF
92
 
93
+ ```
94
+
95
+
96
+ ## โš–๏ธ Capabilities & Limitations
97
 
98
+ ### Capabilities
99
 
100
+ - **Reasoning:** Capable of step-by-step logical reasoning using native `<think>` tags.
101
+ - **Identity Awareness:** Firmly recognizes its persona as **Indica**, built and maintained by **Prashant**.
102
+ - **Cultural Context:** Demonstrates strong understanding of Indian legal systems (IPC/BNS), agriculture, and national-level competitive examinations.
103
+
104
+ ### Limitations
105
+
106
+ - **Parameter Constraints:** As a 1.7B-parameter model, it may exhibit hallucinations during extremely complex technical analysis or detailed legal drafting.
107
+ - **Repetition:** In certain generation contexts, the model may enter repetition loops.
108
+ - *Mitigation:* Increasing `repetition_penalty` to **1.1โ€“1.2** is recommended.
109
+
110
+ ---
111
 
112
+ ## ๐Ÿค Acknowledgements
 
 
 
113
 
114
+ - **Base Weights:** Alibaba Qwen Team
115
+ - **Optimization & GGUF Export:** Unsloth AI
116
+ - **Developer:** Prashant (`prash616`)