[atao2004]

Summary

Migrates the ChatDev + Valkey cookbook from archive/main-pre-reorg to the current CONTRIBUTING.md structure.

What was migrated

• Source: archive/main-pre-reorg:cookbooks/framework-integrations/chatdev/
• Upstream integration: feat(memory): Add Valkey vector memory store OpenBMB/ChatDev#634

The upstream PR is open and stale. The cookbook documents its proposed API but does not import ChatDev because the upstream project is not published as an installable package.

Changes from the original

• Preserved and expanded the three cookbook guides with current lead, audience, prerequisite, Step, security, configuration, and navigation requirements.
• Added a standalone runnable sample that reproduces the verified Valkey behavior without importing ChatDev.
• Added deterministic no-key embeddings as the default, with optional OpenAI and Ollama providers.
• Added exact dependency pins:
  • valkey-glide-sync==2.5.0
  • pytest==8.3.5
• Added docker-compose.yml, .env.example, .gitignore, tests, and expected-output documentation.
• Corrected the original :latest image references and internal-looking hostname.
• Added GLIDE credentials/database forwarding and aligned the sample with the verified upstream defaults.
• Removed obsolete meta.json rendering metadata.
• Added temporary .github/workflows/cookbook-python.yml for framework-integrations/chatdev.
• The CI workflow tests Valkey Bundle 9.1.0 only because the required Search TEXT schema is unavailable in the relevant 8.x Search module.

Validation

Check	Result
Markdown lint	PASS — 0 issues
Syntax/type check	PASS — all four Python files compile
Dependency install (cold cache)	PASS — exact pinned requirements installed
Valkey container + PING	PASS — Finch with valkey/valkey-bundle:9.1.0
Sample run	PASS — quick_start.py assertions passed
Tests	PASS — 18 tests passed

Cookbook structure

cookbooks/framework-integrations/chatdev/
├── README.md
├── 01-getting-started.md
├── 02-vector-memory.md
├── 03-production.md
└── sample/
    ├── README.md
    ├── .env.example
    ├── .gitignore
    ├── docker-compose.yml
    ├── embeddings.py
    ├── quick_start.py
    ├── requirements.txt
    ├── test_valkey_memory.py
    └── valkey_memory.py

Vendor neutrality statement

The default path uses a deterministic local embedding provider and requires no paid service or cloud account. OpenAI and Ollama are documented as optional alternatives. ChatDev affiliation is disclosed as an OpenBMB open-source project.

Version compatibility notes

• Valkey image: valkey/valkey-bundle:9.1.0
• Required Search module support: Valkey Search 1.2.0 or later for the TEXT field and query behavior used here.
• Python: 3.11 in CI.
• Dependencies are exact-pinned.
• Upstream ChatDev PR #634 remains open and unmerged.
• This sample independently reproduces the upstream Valkey commands, key pattern, schema, TTL behavior, and KNN retrieval behavior.

Relationship to other PRs

• Assumes Valkey-Samples PR docs+ci: add semantic-caching cookbook with Python CI (MERGE FIRST FOR PYTHON CI) #45 merges before this cookbook so its temporary Python workflow can later be folded into the shared workflow.
• Documents upstream OpenBMB/ChatDev PR #634.
• No ChatDev source-build or fork dependency is introduced.

Pre-Submit Checklist

• Builds and runs from a clean clone
• Runs against current stable Valkey (or Valkey Bundle)
• No private links, internal references, or local paths
• No marketing language or uncited claims
• Vendor-neutral by default (affiliation disclosed where applicable)
• README explains the Valkey concept demonstrated, prerequisites, and how to run
• Dependencies pinned to specific versions
• CI validates the sample

[jbrinkman]

Closing this draft PR as part of a cookbook program cleanup.