Instructions to use aayanmishra-ml/Athena-R3-1.5B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use aayanmishra-ml/Athena-R3-1.5B with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="aayanmishra-ml/Athena-R3-1.5B")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("aayanmishra-ml/Athena-R3-1.5B")
model = AutoModelForCausalLM.from_pretrained("aayanmishra-ml/Athena-R3-1.5B")
messages = [
    {"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use aayanmishra-ml/Athena-R3-1.5B with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "aayanmishra-ml/Athena-R3-1.5B"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "aayanmishra-ml/Athena-R3-1.5B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/aayanmishra-ml/Athena-R3-1.5B

SGLang

How to use aayanmishra-ml/Athena-R3-1.5B with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "aayanmishra-ml/Athena-R3-1.5B" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "aayanmishra-ml/Athena-R3-1.5B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "aayanmishra-ml/Athena-R3-1.5B" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "aayanmishra-ml/Athena-R3-1.5B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Unsloth Studio

How to use aayanmishra-ml/Athena-R3-1.5B with Unsloth Studio:

Install Unsloth Studio (macOS, Linux, WSL)

curl -fsSL https://unsloth.ai/install.sh | sh
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for aayanmishra-ml/Athena-R3-1.5B to start chatting

Install Unsloth Studio (Windows)

irm https://unsloth.ai/install.ps1 | iex
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for aayanmishra-ml/Athena-R3-1.5B to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for aayanmishra-ml/Athena-R3-1.5B to start chatting

Load model with FastModel

pip install unsloth
from unsloth import FastModel
model, tokenizer = FastModel.from_pretrained(
    model_name="aayanmishra-ml/Athena-R3-1.5B",
    max_seq_length=2048,
)

Docker Model Runner
How to use aayanmishra-ml/Athena-R3-1.5B with Docker Model Runner:
```
docker model run hf.co/aayanmishra-ml/Athena-R3-1.5B
```

Aayan Mishra commited on Apr 9, 2025

Commit

a63b764

verified ·

1 Parent(s): c3161a3

Update README.md

Browse files

Files changed (1) hide show

README.md +16 -9

README.md CHANGED Viewed

@@ -1,5 +1,6 @@
 ---
-base_model: Spestly/Atlas-R1-1.5B-Preview
 tags:
 - text-generation-inference
 - transformers
@@ -38,7 +39,13 @@ language:
 - tl
 - nl
 library_name: transformers
-extra_gated_prompt: "By accessing this model, you agree to comply with ethical usage guidelines and accept full responsibility for its applications. You will not use this model for harmful, malicious, or illegal activities, and you understand that the model's use is subject to ongoing monitoring for misuse. This model is provided 'AS IS' and agreeing to this means that you are responsible for all the outputs generated by you"
 extra_gated_fields:
   Name: text
   Organization: text
@@ -46,13 +53,13 @@ extra_gated_fields:
   Date of Birth: date_picker
   Intended Use:
     type: select
-    options:
-      - Research
-      - Education
-      - Personal Development
-      - Commercial Use
-      - label: Other
-        value: other
   I agree to use this model in accordance with all applicable laws and ethical guidelines: checkbox
   I agree to use this model under the MIT licence: checkbox
 ---

 ---
+base_model:
+- deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B
 tags:
 - text-generation-inference
 - transformers
 - tl
 - nl
 library_name: transformers
+extra_gated_prompt: >-
+  By accessing this model, you agree to comply with ethical usage guidelines and
+  accept full responsibility for its applications. You will not use this model
+  for harmful, malicious, or illegal activities, and you understand that the
+  model's use is subject to ongoing monitoring for misuse. This model is
+  provided 'AS IS' and agreeing to this means that you are responsible for all
+  the outputs generated by you
 extra_gated_fields:
   Name: text
   Organization: text
   Date of Birth: date_picker
   Intended Use:
     type: select
+    options:
+    - Research
+    - Education
+    - Personal Development
+    - Commercial Use
+    - label: Other
+      value: other
   I agree to use this model in accordance with all applicable laws and ethical guidelines: checkbox
   I agree to use this model under the MIT licence: checkbox
 ---