DeepSeek-R1: research setup for working with Ollama, Python DeepSeek locally.

The materials in this repo provide a example Python code to prompt a local installation of DeepSeek-R1 using the python package ollama

See ollama documentation for installing LLMs locally on your machine.

License

The materials have been made available under an MIT license. The materials are as-is with no liability for the author. Please provide credit if you reuse the code in your own work.

Citation

Please feel free to use or adapt the code for your own work. But if so then a citation would be very much appreciated!

@software{ollama_deepseekr1,
author = {Monks, Thomas },
license = {MIT},
title = {{@TheOpenScienceNerd: Interacting with DeepSeek-R1 via Python}},
url = {https://github.com/TheOpenScienceNerd/ollama_deepseek-r1},
doi = {https://doi.org/10.5281/zenodo.14876187}
}

Installation instructions

Installing dependencies

All dependencies can be found in environment.yml and are pulled from conda-forge. To run the code locally, we recommend installing miniforge;

miniforge is Free and Open Source Software (FOSS) alternative to Anaconda and miniconda that uses conda-forge as the default channel for packages. It installs both conda and mamba (a drop in replacement for conda) package managers. We recommend mamba for faster resolving of dependencies and installation of packages.

navigating your terminal (or cmd prompt) to the directory containing the repo and issuing the following command:

mamba env create -f environment.yml

Activate the mamba environment using the following command:

mamba activate ollama

Run Jupyter-lab

jupyter-lab

Repo overview

.
├── binder
│   └── 
├── callcentresim
│   ├── __init__.py
│   ├── model.py
│   └── output_analysis.py
├── CHANGELOG.md
├── CITATION.cff
├── environment.yml
├── LICENSE
├── 01_prompt_deepseek.ipynb
├── 02_conversations.ipynb
└── README.md

• environment.yml - contains the conda environment if you wish to work locally algorithm
• 01_prompt_deepseek.ipynb - main notebook file containing the tutorial code for the interacting with a local deepseek-r1 via python.
• 02_conversations.ipynb -tutorial to setup conversation history as context (data) and pass that to a local LLM via ollama.
• CHANGES.md - changelog with record of notable changes to project between versions.
• CITATION.cff - citation information for the package.
• LICENSE - details of the MIT permissive license of this work.