Instructions to use aayanmishra-ml/Athena-R3-1.5B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
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
Update README.md
Browse files
README.md
CHANGED
|
@@ -37,9 +37,6 @@ language:
|
|
| 37 |
- km
|
| 38 |
- tl
|
| 39 |
- nl
|
| 40 |
-
datasets:
|
| 41 |
-
- openai/gsm8k
|
| 42 |
-
- HuggingFaceH4/ultrachat_200k
|
| 43 |
library_name: transformers
|
| 44 |
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"
|
| 45 |
extra_gated_fields:
|
|
@@ -58,94 +55,4 @@ extra_gated_fields:
|
|
| 58 |
value: other
|
| 59 |
I agree to use this model in accordance with all applicable laws and ethical guidelines: checkbox
|
| 60 |
I agree to use this model under the MIT licence: checkbox
|
| 61 |
-
---
|
| 62 |
-

|
| 63 |
-
# **Atlas Pro**
|
| 64 |
-
|
| 65 |
-
### **Model Overview**
|
| 66 |
-
**Atlas Pro** (Previously known as '🏆 Atlas-Experiment 0403 🧪' in AtlasUI) is an advanced language model (LLM) built on top of **Atlas Flash**. It's designed to provide exceptional performance for professional tasks like coding, mathematics, and scientific problem-solving. Atlas Pro builds on Atlas Flash by adding more fine-tuning and specialization, making it perfect for researchers and advanced users.
|
| 67 |
-
|
| 68 |
-
---
|
| 69 |
-
|
| 70 |
-
### **Key Features**
|
| 71 |
-
- **Improved Problem-Solving:** Handles tricky tasks in programming, math, and sciences better than most models.
|
| 72 |
-
- **Advanced Code Generation:** Produces clean and efficient code, but may still miss edge cases occasionally.
|
| 73 |
-
- **Domain Expertise:** Focused on technical and scientific domains but works well in general contexts too.
|
| 74 |
-
- **Reasoning Improvement:** In this version of Atlas, I have enhanced it's reasoning via synthetic data from models such as Gemini-2.0 Flash Thinking so that it can improve on reasoning.
|
| 75 |
-
---
|
| 76 |
-
|
| 77 |
-
# **Evaluation**
|
| 78 |
-
Below are the evaluations of the Atlas-Pro models and Deepseek's R1 Qwen Distills (The model that started the whole Atlas family):
|
| 79 |
-
|
| 80 |
-
| **Metric** | **Spestly Atlas Pro (7B)** | **Spestly Atlas Pro (1.5B)** | DeepSeek-R1-Distill-Qwen (7B) | DeepSeek-R1-Distill-Qwen (1.5B) |
|
| 81 |
-
|-------------------------|---------------------------|------------------------------|-----------------------------------|-------------------------------------|
|
| 82 |
-
| **Average** | **22.65%** | 12.93% | 11.73% | 7.53% |
|
| 83 |
-
| **IFEval** | 31.54% | 24.30% | **40.38%** | 34.63% |
|
| 84 |
-
| **BBH** | **25.27%** | 9.08% | 7.88% | 4.73% |
|
| 85 |
-
| **MATH** | **38.90%** | 25.83% | 0.00% | 0.00% |
|
| 86 |
-
| **GPQA** | **11.63%** | 6.26% | 3.91% | 2.97% |
|
| 87 |
-
| **MUSR** | **6.65%** | 1.86% | 3.55% | 2.08% |
|
| 88 |
-
| **MMLU-Pro** | **21.89%** | 10.28% | 14.68% | 0.78% |
|
| 89 |
-
| **Carbon Emissions (kg)** | 0.69 kg | **0.59 kg** | 0.68 kg | 0.62 kg |
|
| 90 |
-
|
| 91 |
-
|
| 92 |
-
|
| 93 |
-
|
| 94 |
-
---
|
| 95 |
-
### **Intended Use Cases**
|
| 96 |
-
Atlas Pro works best for:
|
| 97 |
-
- **Technical Professionals:** Helping developers, engineers, and scientists solve complex problems.
|
| 98 |
-
- **Educational Assistance:** Offering clear, step-by-step help for students and teachers.
|
| 99 |
-
- **Research Support:** Assisting in theoretical and applied science work.
|
| 100 |
-
- **Enterprise Tools:** Integrating into company workflows for smarter systems.
|
| 101 |
-
|
| 102 |
-
---
|
| 103 |
-
|
| 104 |
-
### **NOTICE**
|
| 105 |
-
Atlas Pro is built on **Atlas Flash** and improved to meet high standards. Here’s how it’s made:
|
| 106 |
-
|
| 107 |
-
1. **Base Model:** Built upon **Atlas Flash**, which is already quite capable.
|
| 108 |
-
2. **Fine-Tuning Details:**
|
| 109 |
-
- Used datasets specific to programming, math, and scientific challenges and overall reasoning abilities.
|
| 110 |
-
- Refined its performance for professional scenarios.
|
| 111 |
-
3. **Performance Highlights:**
|
| 112 |
-
- Beats benchmarks with high accuracy, though occasional tweaks might still improve outputs.
|
| 113 |
-
---
|
| 114 |
-
|
| 115 |
-
### **Limitations**
|
| 116 |
-
- **Knowledge Cutoff:** It doesn’t know about anything recent unless updated.
|
| 117 |
-
- **Hardware Requirements:** Needs high-end GPUs to run smoothly.
|
| 118 |
-
- **Specialization Bias:** While amazing in its focus areas, general chat capabilities might not be as good as other models.
|
| 119 |
-
- **Token Leakage:** In some very rare cases (~1/167), Atlas Pro will experience some token leakage.
|
| 120 |
-
|
| 121 |
-
---
|
| 122 |
-
|
| 123 |
-
### **Licensing**
|
| 124 |
-
Atlas Pro is released under the **MIT**, which prohibits harmful uses. Make sure to follow the rules in the license agreement.
|
| 125 |
-
|
| 126 |
-
---
|
| 127 |
-
|
| 128 |
-
### **Acknowledgments**
|
| 129 |
-
Created by **Spestly** as part of the **Atlas Model Family**, Atlas Pro builds on the strong foundation of **Atlas Flash**. Special thanks to **Deepseek's R1 Qwen Distilles** for helping make it happen.
|
| 130 |
-
|
| 131 |
-
---
|
| 132 |
-
|
| 133 |
-
### **Usage**
|
| 134 |
-
You can use Atlas Pro with this code snippet:
|
| 135 |
-
|
| 136 |
-
```python
|
| 137 |
-
from transformers import AutoModelForCausalLM, AutoTokenizer
|
| 138 |
-
|
| 139 |
-
# Load the Atlas Pro model
|
| 140 |
-
model_name = "Spestly/Atlas-R1-Pro-1.5B-Preview"
|
| 141 |
-
tokenizer = AutoTokenizer.from_pretrained(model_name)
|
| 142 |
-
model = AutoModelForCausalLM.from_pretrained(model_name)
|
| 143 |
-
|
| 144 |
-
# Generate a response
|
| 145 |
-
prompt = "Write a Python function to calculate the Fibonacci sequence."
|
| 146 |
-
inputs = tokenizer(prompt, return_tensors="pt")
|
| 147 |
-
outputs = model.generate(**inputs, max_length=200)
|
| 148 |
-
response = tokenizer.decode(outputs[0], skip_special_tokens=True)
|
| 149 |
-
|
| 150 |
-
print(response)
|
| 151 |
-
```
|
|
|
|
| 37 |
- km
|
| 38 |
- tl
|
| 39 |
- nl
|
|
|
|
|
|
|
|
|
|
| 40 |
library_name: transformers
|
| 41 |
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"
|
| 42 |
extra_gated_fields:
|
|
|
|
| 55 |
value: other
|
| 56 |
I agree to use this model in accordance with all applicable laws and ethical guidelines: checkbox
|
| 57 |
I agree to use this model under the MIT licence: checkbox
|
| 58 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|