docs(agents): add Cursor Cloud dev environment setup notes - #11378
Draft
sara4dev wants to merge 1 commit into
Draft
docs(agents): add Cursor Cloud dev environment setup notes#11378sara4dev wants to merge 1 commit into
sara4dev wants to merge 1 commit into
Conversation
Document GPU-free local development caveats discovered while setting up the Cloud environment: gcc/g++ toolchain requirement for the vendored ZeroMQ build, offline Hugging Face handling with local sample models, file-based discovery to run without etcd/NATS, and a frontend+mocker smoke test. Signed-off-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Saravana Periyasamy <sara4dev@users.noreply.github.com>
github-actions
Bot
added
docs
documentation
Contributor
|
This PR is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days. |
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
2 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.
Overview:
Sets up the Dynamo development environment on a Cursor Cloud VM (no GPU, restricted egress) and documents the non-obvious caveats discovered so future agents can build, test, lint, and run the GPU-free path (frontend + KV router + mock worker) without re-deriving them.
This PR only adds a
## Cursor Cloud specific instructionssection toAGENTS.md; no code is changed. Toolchain/system changes (gcc default,uv, system libs) are captured in the VM snapshot + startup update script rather than in the repo.Details:
Verified end-to-end in the Cloud VM:
libhwloc-dev,libclang-dev,protobuf-compiler,cmake, …),uv,maturin developfor the PyO3 bindings, editable installs ofai-dynamoandgpu_memory_service. Root cause fixed: defaultcc/c++are clang and cannot build/link the vendored ZeroMQ (zmq-sys); switchedupdate-alternativestogcc/g++.dynamo.frontend+dynamo.mockerwith--discovery-backend file(no etcd/NATS) using a local sample tokenizer with achat_template;/v1/chat/completions(streaming + non-streaming) returns HTTP 200 through the router.pytest -m unit tests/→ 76 passed / 21 skipped (optional GPU/backends) / 2 optionalkvbmimport failures;cargo testcore crates green.pre-commitdeterministic hooks (isort, black, flake8, clang-format, codespell, ruff, file checks) pass;cargo fmt --all --checkpasses.The AGENTS.md notes document: the gcc toolchain requirement, no-GPU worker via
dynamo.mocker, offline Hugging Face handling with local fixture models, file-based discovery to avoid etcd/NATS, thechat_templaterequirement for chat completions, and the GPU-free smoke test.Where should the reviewer start?
AGENTS.md→ the new## Cursor Cloud specific instructionssection.Related Issues
🚫 This PR is NOT linked to an issue: