Skip to content

docs: add Cursor Cloud dev environment instructions to AGENTS.md - #331

Draft
manit0700 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-e13c
Draft

docs: add Cursor Cloud dev environment instructions to AGENTS.md#331
manit0700 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-e13c

Conversation

@manit0700

Copy link
Copy Markdown
Owner

Summary

Sets up the EvolveAgent AI development environment (backend + frontend) for Cursor Cloud agents and documents non-obvious startup/testing caveats discovered during setup. The only code/repo change is an appended ## Cursor Cloud specific instructions section in AGENTS.md; the dependency install/refresh is handled by the VM startup update script (not committed here).

What was set up

  • Backend (FastAPI): Python venv + pip install -r backend/requirements.txt
  • Frontend (React + Vite): npm install in frontend/
  • Installed the python3.12-venv system package (needed once to create the backend venv)

Verification

Service Command Result
Backend tests cd backend && ./venv/bin/pytest -q 1444 passed, 9 skipped
Frontend tests cd frontend && npm run test 56 passed
Frontend build cd frontend && npm run build built (1609 modules)
Backend run ./venv/bin/uvicorn app.main:app --reload --port 8000 /health ok; POST /api/run returns multi-agent response
Frontend run npm run dev -- --host 127.0.0.1 --port 5173 serves 200; UI loads

Hello-world task: sent a chat message in Simple Mode Chat and received a multi-agent orchestrated response (mock mode), no errors.

evolveagent_chat_hello_world.mp4

Chat response in EvolveAgent AI

Key notes (also in AGENTS.md)

  • App runs fully offline in mock/JSON mode; no .env or API keys required for dev.
  • Do NOT copy .env.example to backend/.env before running tests — it sets REDIS_URL/DATABASE_URL and breaks test_default_backend_is_json_and_status (CI runs with these unset).
  • Some tests (e.g. business-intelligence) assume a clean backend/app/data/; running the app/suite writes runtime JSON there. Clear with git clean -fdx backend/app/data/ for a pristine baseline. Fresh checkouts/CI are unaffected.

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

…S.md

Co-authored-by: Manit Dankhara <manit0700@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants