Mmxa commited on
Commit
30f0475
·
verified ·
1 Parent(s): 612c3c8

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +61 -14
README.md CHANGED
@@ -1,23 +1,70 @@
1
  ---
 
 
 
 
2
  tags:
3
- - gguf
4
- - llama.cpp
 
 
 
 
5
  - unsloth
6
-
 
 
 
 
 
 
 
7
  ---
8
 
9
- # LaboAI-0.3.2-1.5B : GGUF
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
 
11
- This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
 
 
 
12
 
13
- **Example usage**:
14
- - For text only LLMs: `llama-cli -hf LaboAI/LaboAI-0.3.2-1.5B --jinja`
15
- - For multimodal models: `llama-mtmd-cli -hf LaboAI/LaboAI-0.3.2-1.5B --jinja`
16
 
17
- ## Available Model files:
18
- - `Qwen2.5-1.5B-Instruct.Q4_K_M.gguf`
19
 
20
- ## Ollama
21
- An Ollama Modelfile is included for easy deployment.
22
- This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
23
- [<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
 
 
 
 
1
  ---
2
+ language:
3
+ - en
4
+ - es
5
+ - code
6
  tags:
7
+ - code-generation
8
+ - android
9
+ - kotlin
10
+ - java
11
+ - jetpack-compose
12
+ - qwen2.5
13
  - unsloth
14
+ - gguf
15
+ - ollama
16
+ - 1.5b
17
+ license: apache-2.0
18
+ base_model: Qwen/Qwen2.5-1.5B-Instruct
19
+ datasets:
20
+ - giggiovpg/ornith-android-instruct
21
+ - giggiovpg/android-kotlin-compose-compiler-verified
22
  ---
23
 
24
+ # 🤖 LaboAI-0.3.2-1.5B
25
+
26
+ This is a lightweight language model (1.5B parameters) fine-tuned specifically for generating, understanding, and debugging **Kotlin** code and **Android** development (with a strong emphasis on Jetpack Compose and modern architectures).
27
+
28
+ It has been optimized using **QLoRA (4-bit)** to be extremely memory-efficient, allowing it to run locally on GPUs with limited VRAM (such as the NVIDIA Quadro M2000 with 4GB) without sacrificing response quality.
29
+
30
+ ## 📋 Model Details
31
+
32
+ - **Developed by:** Mmxa
33
+ - **Organization:** LaboAI
34
+ - **Model type:** Causal Language Model (Code Generation)
35
+ - **Languages:** Kotlin, Java, English, Spanish (instructions)
36
+ - **License:** Apache 2.0 (inherited from Qwen2.5)
37
+ - **Base model:** [Qwen/Qwen2.5-1.5B-Instruct](https://huggingface.co/Qwen/Qwen2.5-1.5B-Instruct)
38
+
39
+ ## 🚀 Uses
40
+
41
+ ### Direct Use
42
+ - Generating boilerplate for Activities, Fragments, or ViewModels in Kotlin.
43
+ - Creating modern UI components with **Jetpack Compose**.
44
+ - Debugging compilation errors or logic flaws in Android code snippets.
45
+ - Translating legacy Java logic into modern Kotlin.
46
+
47
+ ### Ecosystem Use (Recommended)
48
+ This model shines when used as a local coding assistant via **Ollama** and the **Continue** extension in VS Code. This guarantees complete privacy (your code never leaves your machine) and ultra-low latency.
49
+
50
+ ### Out-of-Scope Uses
51
+ - It is not optimized for general chat, creative writing, or complex mathematical reasoning.
52
+ - It should not be used to generate malicious code or exploits.
53
+ - All generated code must be reviewed by a human developer before being merged into a main branch.
54
 
55
+ ## ⚠️ Limitations and Risks
56
+ - **API Hallucinations:** In rare cases, it might suggest deprecated Android APIs (e.g., `AsyncTask` or old XML layouts) instead of Coroutines or Compose.
57
+ - **Context Window:** Limited to 2048 tokens. It is not suitable for analyzing massive, multi-thousand-line codebase files all at once.
58
+ - **Dependencies:** It does not have real-time knowledge of the latest Android library updates (e.g., recent changes in Hilt or Room).
59
 
60
+ ## 💻 How to Get Started (Local Setup)
 
 
61
 
62
+ This repository includes both the original format (`safetensors`) and the quantized format (`GGUF` Q4_K_M). To use it on your PC with a 4GB VRAM GPU:
 
63
 
64
+ 1. Install [Ollama](https://ollama.com/).
65
+ 2. Download the `.gguf` file from this repository (e.g., `LaboAI-0.3.2-1.5B-Q4_K_M.gguf`).
66
+ 3. Create a file named `Modelfile` in the same folder with the following content:
67
+ ```text
68
+ FROM ./LaboAI-0.3.2-1.5B-Q4_K_M.gguf
69
+ PARAMETER stop "### Instruction:"
70
+ PARAMETER stop "### Response:"