You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This PR adds an example to deploy a Relayminer exposing a deepseek service as well as how to deploy a deepseek datanode on Kubernetes (using Ollama deepseek-r1:1.5b model)
Primary Changes:
poktroll documentation.
Type of change
Select one or more from the following:
New feature, functionality or library
Bug fix
Code health or cleanup
Documentation
Other (specify)
Sanity Checklist
I have updated the GitHub Issue Metadata: assignees, reviewers, labels, project, iteration and milestone
For docs: make docusaurus_start
For small changes: make go_develop_and_test and make test_e2e
For major changes: devnet-test-e2e label to run E2E tests in CI
eddyzags
changed the title
docs(operate): relayminer exposing deepseek service + datanodes
docs(operate): relayminer exposing deepseek service + datanodes deployment on Kubernetes (using ollama)
Oct 13, 2025
eddyzags
changed the title
docs(operate): relayminer exposing deepseek service + datanodes deployment on Kubernetes (using ollama)
docs(operate): relayminer exposing deepseek service + datanode deployment on Kubernetes (using ollama)
Oct 13, 2025
Hi @eddyzags , there are several issues with the approach presented in this document:
Ollama is not a production ready product, so presenting it to be staked in a network where you expect multiple concurrent calls does not seem like a good idea. There are better alternatives to do this, like vLLM or TGI.
You are showing a service that goes straight to /api/generate which results in the service only being able to respond in Ollama's API format (in a very specific endpoint), something that is not being accepted as the industry standard. We proposed to use OpenAI API standard which is much more broadly accepted. Also, staking a fixed endpoint cripples the users' ability to select a desired type of completion, like /v1/completions or /v1/chat/completions.
You are staking a deepSeek-r1:1.5b model into a service that states in it's description that it is Deepseek V3 0324 (a ~600B parameter model). While there is no way to enforce models on services (as we lengthy discussed in the forum), presenting a guide that offends the service description does not seem correct. There is another service that can be used to stake language models models in mainnet which is text-generation, in this one the only assumption is that you provide an OpenAI API compatible endpoint.
The endpoint you are staking responds to "model": "deepseek-r1:1.5b", there is no way for a app or gateway to know the value of this parameter. We have created a solution for this, a sidecar for ML services that override the deployed model name so you can accept an standard name, like pocket_network.
Regarding streaming, there is a very old implementation that you can use to allow streaming, and even if you deploy the basic relay miner, setting "stream": true won't break the relayminer, yo will just receive the whole stream in a single payload. So, this clarification is confusing and will get old fast.
A minor detail, 1000069upokt is not enough to stake a Supplier in mainnet.
There was a long conversation around the topic of deploying language models in the network, while it was done in the Morse era, none of the conclusions changed with Shannon. There we explain why some things needs to be standardized (API format) and why using service names with vendor names makes no sense.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
relayminerChanges related to the RelayminersupplierChanges related to the Supplier actor
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds an example to deploy a Relayminer exposing a deepseek service as well as how to deploy a
deepseekdatanode on Kubernetes (using Ollamadeepseek-r1:1.5bmodel)Primary Changes:
Type of change
Select one or more from the following:
Sanity Checklist
assignees,reviewers,labels,project,iterationandmilestonemake docusaurus_startmake go_develop_and_testandmake test_e2edevnet-test-e2elabel to run E2E tests in CImake test_e2e_oneshot