From 800f60cfb912c70fff72f8b8537a9d65a0db4528 Mon Sep 17 00:00:00 2001
From: SufianTA <saldogom@mit.edu>
Date: Sun, 10 May 2026 10:21:15 -0700
Subject: [PATCH] docs: add credential-light smoke test

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index f8fff6c..6eea423 100644
--- a/README.md
+++ b/README.md
@@ -59,6 +59,23 @@ uv pip install -e .
 uv pip install openai==1.82.1  # Ensure correct OpenAI version
 ```
 
+### Credential-light smoke test
+
+Before downloading MedeaDB or configuring model-provider credentials, verify that
+the package imports correctly in the active environment:
+
+```bash
+python - <<'PY'
+import medea
+
+print("Medea import OK")
+print(medea.__file__)
+PY
+```
+
+This check is intentionally limited to package import health. Full agent runs
+still require `MEDEADB_PATH` and at least one configured LLM provider key.
+
 ### Download MedeaDB
 
 Download required datasets from Hugging Face: