Update READMEs: replace invalid free models with verified ones

Changes:
- Replace nvidia/llama-3.1-nemotron-ultra-253b-v1:free with venice/uncensored:free (404 error - model removed from free tier)
- Replace deepseek/deepseek-chat:free with verified working models (404 error)
- Replace qwen/thudm free models with verified alternatives
- Add note about OpenRouter free tier limits (50 req/day, 1000/day with $10+ credits)
- Updated Python and main README examples with verified free models:
  - meta-llama/llama-4-maverick:free
  - deepseek/deepseek-r1:free
  - meta-llama/llama-3.3-70b-instruct:free
  - venice/uncensored:free

Related to OpenRouter policy changes in 2025 (see FINAL_SUMMARY_FREE_MODELS.md)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: cafferychen777

README.md

@@ -260,6 +260,7 @@ pip install google-genai
   - Supports models from OpenAI, Anthropic, Meta, Google, Mistral, and more
   - Format: 'provider/model-name' (e.g., 'openai/gpt-5', 'anthropic/claude-opus-4.1')
   - Free models available with `:free` suffix (e.g., 'deepseek/deepseek-r1:free', 'meta-llama/llama-4-maverick:free')
+  - **Note**: Free tier limits (as of Oct 2025): 50 requests/day (1000/day with $10+ credits), 20 requests/minute. Some models may be unavailable.
 
 ## Usage Examples
 
@@ -357,7 +358,7 @@ free_models_results = interactive_consensus_annotation(
     tissue="blood",
     models=[
         {"provider": "openrouter", "model": "meta-llama/llama-4-maverick:free"},      # Meta Llama 4 Maverick (free)
-        {"provider": "openrouter", "model": "nvidia/llama-3.1-nemotron-ultra-253b-v1:free"},  # NVIDIA Nemotron Ultra 253B (free)
+        {"provider": "openrouter", "model": "venice/uncensored:free"},                # Venice Uncensored (free)
         {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},             # DeepSeek R1 (free, advanced reasoning)
         {"provider": "openrouter", "model": "meta-llama/llama-3.3-70b-instruct:free"} # Meta Llama 3.3 70B (free)
     ],
@@ -814,7 +815,7 @@ free_consensus_results <-
     tissue_name = "your tissue type", # e.g., "human heart"
     models = c(
       "meta-llama/llama-4-maverick:free",      # Meta Llama 4 Maverick (free)
-      "nvidia/llama-3.1-nemotron-ultra-253b-v1:free",  # NVIDIA Nemotron Ultra 253B (free)
+      "venice/uncensored:free",                # Venice Uncensored (free)
       "deepseek/deepseek-r1:free",             # DeepSeek R1 (free, advanced reasoning)
       "meta-llama/llama-3.3-70b-instruct:free" # Meta Llama 3.3 70B (free)
     ),

python/README.md

@@ -32,6 +32,8 @@ Single-cell RNA sequencing has revolutionized our understanding of cellular hete
   - OpenRouter (Access to multiple models through a single API)
     - Supports models from OpenAI, Anthropic, Meta, Mistral and more
     - Format: 'provider/model-name' (e.g., 'openai/gpt-5', 'anthropic/claude-3-opus')
+    - Free models available with `:free` suffix (e.g., 'meta-llama/llama-4-maverick:free')
+    - Free tier limits (as of Oct 2025): 50 requests/day (1000/day with $10+ credits)
 - **Seamless Integration**:
   - Works directly with Scanpy/AnnData workflows
   - Compatible with scverse ecosystem
@@ -432,7 +434,7 @@ free_model_annotations = annotate_clusters(
     marker_genes=marker_genes,
     species='human',
     tissue='peripheral blood',
-    provider_config={"provider": "openrouter", "model": "deepseek/deepseek-chat:free"}  # Free model with :free suffix
+    provider_config={"provider": "openrouter", "model": "meta-llama/llama-4-maverick:free"}  # Free model with :free suffix
 )
 
 # Print annotations from different models
@@ -483,10 +485,10 @@ result = interactive_consensus_annotation(
     species='human',
     tissue='peripheral blood',
     models=[
-        {"provider": "openrouter", "model": "deepseek/deepseek-chat:free"},      # DeepSeek (free)
-        {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},         # Microsoft (free)
-        {"provider": "openrouter", "model": "qwen/qwen-2.5-7b-instruct:free"},   # Qwen (free)
-        {"provider": "openrouter", "model": "thudm/glm-4-9b:free"}               # GLM (free)
+        {"provider": "openrouter", "model": "meta-llama/llama-4-maverick:free"},      # Llama 4 (free)
+        {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},             # DeepSeek R1 (free)
+        {"provider": "openrouter", "model": "meta-llama/llama-3.3-70b-instruct:free"}, # Llama 3.3 (free)
+        {"provider": "openrouter", "model": "venice/uncensored:free"}                 # Venice (free)
     ],
     consensus_threshold=0.7,
     max_discussion_rounds=3,
@@ -616,7 +618,7 @@ result = interactive_consensus_annotation(
     models=[
         'gpt-5',                                                      # Direct API (paid)
         {"provider": "openrouter", "model": "openai/gpt-5"},          # OpenRouter (paid)
-        {"provider": "openrouter", "model": "deepseek/deepseek-chat:free"},  # OpenRouter (free)
+        {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},    # OpenRouter (free)
     ],
     consensus_threshold=0.8,                # Higher threshold to force discussion
     max_discussion_rounds=3,                # Allow multiple rounds of discussion
@@ -629,10 +631,10 @@ result_free = interactive_consensus_annotation(
     species='human',
     tissue='peripheral blood',
     models=[
-        {"provider": "openrouter", "model": "deepseek/deepseek-chat:free"},      # DeepSeek (free)
-        {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},         # Microsoft (free)
-        {"provider": "openrouter", "model": "qwen/qwen-2.5-7b-instruct:free"},   # Qwen (free)
-        {"provider": "openrouter", "model": "thudm/glm-4-9b:free"}               # GLM (free)
+        {"provider": "openrouter", "model": "meta-llama/llama-4-maverick:free"},      # Llama 4 (free)
+        {"provider": "openrouter", "model": "deepseek/deepseek-r1:free"},             # DeepSeek R1 (free)
+        {"provider": "openrouter", "model": "meta-llama/llama-3.3-70b-instruct:free"}, # Llama 3.3 (free)
+        {"provider": "openrouter", "model": "venice/uncensored:free"}                 # Venice (free)
     ],
     consensus_threshold=0.7,
     max_discussion_rounds=2,