Repository navigation
Fix LangChain and Docker quickstarts so they run as pasted - #81
Merged
Merged
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
…tall steps cyborgdb-core, cyborgdb and cyborgdb-service all require Python >= 3.10. The python3 that ships with macOS is 3.9.6, and pip reports 'No matching distribution found' with no hint why. A fresh-machine run today hit this before any of the LangChain breaks this PR fixes.
ahellegit
approved these changes
Oct 14, 2026
This branch was successfully deployed
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Why
A developer who copies the LangChain quick start from this page gets an
ImportError(langchain_openaiis not installed by thelangchainextra) and then an API-key validation failure on the placeholder key; the Docker quickstart asks forsudoanddocker-composev1 and lists specs for an image we no longer ship. On v0.18.0 this is the difference between a first query in about two minutes and giving up.What changed
all-MiniLM-L6-v2model,api_key=""(free tier), and deletes the index at the end so the snippet can be re-run; adds the key-loss warning, a one-line "how to keep the index" pointer, a note thatgenerate_key(save=True)is SDK-only, and OpenAI embeddings as an opt-in variant.api_key=""and a key-retention comment.pip install ...[extra]on current pages (zsh expands the brackets) and added a lint toscripts/docs.py checkso it cannot regress.sudo,docker composev2, and specs that match the shipped image (python:3.14-slim, about 124 MB compressed, no PyTorch).python3is 3.9 andpip install cyborgdb-corefails with no useful message on it).docs.json: a "Quickstart" navbar link, the Get API Key button now goes tocyborgdb.co/new(the bare domain redirects to the marketing site), and a/quickstart-dockershort redirect for READMEs.Verification
uv venvwithcyborgdb-core[langchain]==0.18.0: run 1 and run 2 both printhello world/goodbye world(1.8 s and 0.4 s wall time); the reopen-by-constructor line was exercised the same way.python3 scripts/docs.py check,sync-next --checkandseo --checkall pass;sync-nextmirrored five pages intonext/.@langchain/openai; same class of issue, separate follow-up.Closes cyborginc/cyborgdb-core#2706
Closes cyborginc/cyborgdb-core#2707
Closes cyborginc/cyborgdb-core#2708
Closes cyborginc/cyborgdb-core#2710
Refs cyborginc/cyborgdb-core#2705, cyborginc/cyborgdb-core#2701