Instructions to use recursive-models/recursive1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use recursive-models/recursive1 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="recursive-models/recursive1")# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("recursive-models/recursive1", dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use recursive-models/recursive1 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "recursive-models/recursive1" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "recursive-models/recursive1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/recursive-models/recursive1
- SGLang
How to use recursive-models/recursive1 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 "recursive-models/recursive1" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "recursive-models/recursive1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "recursive-models/recursive1" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "recursive-models/recursive1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use recursive-models/recursive1 with Docker Model Runner:
docker model run hf.co/recursive-models/recursive1
| { | |
| "architectures": [ | |
| "TRMForCausalLM" | |
| ], | |
| "dtype": "bfloat16", | |
| "model_type": "trm", | |
| "pad_token_id": 50283, | |
| "transformers_version": "4.57.1", | |
| "trm_config_dict": { | |
| "H_layers": 0, | |
| "batch_size": 1, | |
| "causal": true, | |
| "dropout": 0.2, | |
| "expansion": 4, | |
| "forward_dtype": "bfloat16", | |
| "freeze_embeddings": false, | |
| "halt_exploration_prob": 0.1, | |
| "halt_max_steps": 8, | |
| "hidden_size": 768, | |
| "loss": { | |
| "loss_type": "stablemax_cross_entropy", | |
| "name": "losses@ACTLossHead" | |
| }, | |
| "name": "recursive_reasoning.trm@TinyRecursiveModel", | |
| "no_ACT_continue": true, | |
| "num_heads": 12, | |
| "num_layers": 8, | |
| "num_puzzle_identifiers": 1, | |
| "pos_encodings": "rope", | |
| "pretrained_embeddings_model": "Alibaba-NLP/gte-modernbert-base", | |
| "puzzle_emb_len": 0, | |
| "puzzle_emb_ndim": 0, | |
| "residual_recursion": false, | |
| "seq_len": 512, | |
| "vocab_size": 50368, | |
| "y_cycles": 2, | |
| "z_cycles": 3 | |
| } | |
| } | |