CoolFace
Modelpublic

AxionLab-official/MiniBot-0.9M-Instruct

sourceHugging Facemitupdated 6mo agoView on Hugging Face
1likes242downloads
Model Card

๐Ÿง  MiniBot-0.9M-Instruct

Instruction-tuned GPT-2 style language model (~900K parameters) optimized for Portuguese conversational tasks.

![Model](https://huggingface.co/AxionLab-official/MiniBot-0.9M-Instruct) ![License](https://opensource.org/licenses/MIT) ![Language](https://huggingface.co/AxionLab-official/MiniBot-0.9M-Instruct) ![Parameters](https://huggingface.co/AxionLab-official/MiniBot-0.9M-Instruct)


๐Ÿ“Œ Overview

MiniBot-0.9M-Instruct is the instruction-tuned version of MiniBot-0.9M-Base, designed to follow prompts more accurately, respond to user inputs, and generate more coherent conversational outputs in Portuguese.

Built on a GPT-2 architecture (~0.9M parameters), this model was fine-tuned on conversational and instruction-style data to improve usability in real-world interactions.


๐ŸŽฏ Key Characteristics

AttributeDetail
๐Ÿ‡ง๐Ÿ‡ท LanguagePortuguese (primary)
๐Ÿง  ArchitectureGPT-2 style (Transformer decoder-only)
๐Ÿ”ค EmbeddingsGPT-2 compatible
๐Ÿ“‰ Parameters~900K
โš™๏ธ Base ModelMiniBot-0.9M-Base
๐ŸŽฏ Fine-tuningInstruction tuning (supervised)
โœ… AlignmentBasic prompt-following behavior

๐Ÿง  What Changed from Base?

Instruction tuning introduced significant behavioral improvements with no architectural changes:

FeatureBaseInstruct
Prompt understandingโŒโœ…
Conversational flowโš ๏ธ Partialโœ…
Instruction followingโŒโœ…
Overall coherenceLowImproved
Practical usabilityExperimentalFunctional
๐Ÿ’ก The model is now significantly more usable in chat scenarios.

๐Ÿ—๏ธ Architecture

The core architecture remains identical to the base model:

  • โ€”Decoder-only Transformer (GPT-2 style)
  • โ€”Token embeddings + positional embeddings
  • โ€”Self-attention + MLP blocks
  • โ€”Autoregressive generation

No structural changes were made โ€” only behavioral improvement through fine-tuning.


๐Ÿ“š Fine-Tuning Dataset

The model was fine-tuned on a Portuguese instruction-style conversational dataset composed of:

  • โ€”๐Ÿ’ฌ Questions and answers
  • โ€”๐Ÿ“‹ Simple instructions
  • โ€”๐Ÿค– Assistant-style chat
  • โ€”๐ŸŽญ Basic roleplay
  • โ€”๐Ÿ—ฃ๏ธ Natural conversations

Expected format:

User: Me explique o que รฉ gravidade
Bot: A gravidade รฉ a forรงa que atrai objetos com massa...

Training strategy:

  • โ€”Supervised Fine-Tuning (SFT)
  • โ€”Pattern learning for instruction-following
  • โ€”No RLHF or preference optimization

๐Ÿ’ก Capabilities

โœ… Strengths

  • โ€”Following simple instructions
  • โ€”Answering basic questions
  • โ€”Conversing more naturally
  • โ€”Higher coherence in short responses
  • โ€”More consistent dialogue structure

โŒ Limitations

  • โ€”Reasoning is still limited
  • โ€”May generate incorrect facts
  • โ€”Does not retain long context
  • โ€”Sensitive to poorly structured prompts
โš ๏ธ Even with instruction tuning, this remains an extremely small model. Adjust expectations accordingly.

๐Ÿš€ Getting Started

Installation

bash
pip install transformers torch

Usage with Hugging Face Transformers

python
from transformers import AutoTokenizer, AutoModelForCausalLM

model_name = "AxionLab-official/MiniBot-0.9M-Instruct"

tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(model_name)

prompt = "User: Me diga uma curiosidade sobre o espaรงo\nBot:"
inputs = tokenizer(prompt, return_tensors="pt")

outputs = model.generate(
    **inputs,
    max_new_tokens=80,
    temperature=0.7,
    top_p=0.9,
    do_sample=True,
)

print(tokenizer.decode(outputs[0], skip_special_tokens=True))

โš™๏ธ Recommended Settings

ParameterRecommended ValueDescription
temperature0.6 โ€“ 0.8Controls randomness
top_p0.85 โ€“ 0.95Nucleus sampling
do_sampleTrueEnable sampling
max_new_tokens40 โ€“ 100Response length
๐Ÿ’ก Instruct models tend to perform better at lower temperatures. Try values around 0.65 for more accurate and focused responses.

๐Ÿงช Intended Use Cases

Use CaseSuitability
๐Ÿ’ฌ Lightweight Portuguese chatbotsโœ… Ideal
๐ŸŽฎ NPCs and gamesโœ… Ideal
๐Ÿง  Fine-tuning experimentsโœ… Ideal
๐Ÿ“š NLP educationโœ… Ideal
โšก Local / CPU-only applicationsโœ… Ideal
๐Ÿญ Critical production environmentsโŒ Not recommended

โš ๏ธ Disclaimer

  • โ€”Extremely small model (~900K parameters)
  • โ€”No robust alignment (no RLHF)
  • โ€”May generate incorrect or nonsensical responses
  • โ€”Not suitable for critical production environments

๐Ÿ”ฎ Future Work

  • โ€”[ ] ๐Ÿง  Reasoning-tuned version (MiniBot-Reason)
  • โ€”[ ] ๐Ÿ“ˆ Scaling to 1Mโ€“10M parameters
  • โ€”[ ] ๐Ÿ“š Larger and more diverse dataset
  • โ€”[ ] ๐Ÿค– Improved response alignment
  • โ€”[ ] ๐Ÿงฉ Tool-use experiments

๐Ÿ“œ License

Distributed under the MIT License. See `LICENSE` for more details.


๐Ÿ‘ค Author

Developed by [AxionLab](https://huggingface.co/AxionLab-official) ๐Ÿ”ฌ


<div align="center"> <sub>MiniBot-0.9M-Instruct ยท AxionLab ยท MIT License</sub> </div>