feat: update examples and dependencies for pytidb version 0.0.13.dev8

[Mini256]

• Updated .env.example files across various examples to reflect new database names.
• Modified reqs.txt files in examples to use the latest pytidb version 0.0.13.dev8.
• Added a new rule in .cursor/rules/update-examples.mdc for updating pytidb dependencies in example projects.
• Introduced a custom embedding example using the BGE-M3 model in examples/custom_embedding.
• Refactored existing examples to ensure compatibility with the latest changes in the pytidb library.
• Enhanced README files to provide clearer instructions and updated information.

[Mini256]

@claude

[claude]

Claude finished @Mini256's task —— View job

---

PR Review: Update examples and dependencies for pytidb version 0.0.13.dev8

Todo List:

• Read repository CLAUDE.md for guidelines
• Review version consistency across all reqs.txt files
• Review new custom embedding example structure
• Review refactored examples for quality and compatibility
• Check documentation updates and README improvements
• Review core pytidb code changes
• Provide comprehensive feedback summary

---

✅ Overall Assessment

This PR successfully updates the pytidb project to version 0.0.13.dev8 with comprehensive example updates and introduces valuable new functionality. The changes are well-structured and maintain good code quality throughout.

🔧 Key Improvements

✅ Excellent Additions:

1. New Custom Embedding Example: The BGE-M3 custom embedding implementation is well-architected:

   • Clean inheritance from BaseEmbeddingFunction
   • Proper error handling and type hints
   • Comprehensive documentation and README
   • Efficient batch processing support
   • Good hardware requirements documentation

2. GraphRAG Example: New GraphRAG demo adds valuable functionality for advanced RAG applications

3. Cursor Rule: Added automation rule for updating examples - great for maintenance

4. Enhanced Vector Search: Streamlit app improvements with better error handling and UI

✅ Code Quality:

• Consistent code style across all examples
• Proper error handling and logging
• Good documentation and inline comments
• Type hints used throughout
• Clean separation of concerns

⚠️ Issues Found

🚨 Critical Issue - Version Inconsistency:

Multiple examples still reference the old version 0.0.13.dev7 instead of 0.0.13.dev8:

examples/basic/reqs.txt:pytidb==0.0.13.dev7
examples/custom_embedding/reqs.txt:pytidb==0.0.13.dev7  
examples/hybrid_search/reqs.txt:pytidb==0.0.13.dev7
examples/text2sql/reqs.txt:pytidb==0.0.13.dev7
examples/memory/reqs.txt:pytidb==0.0.13.dev7
examples/quickstart/reqs.txt:pytidb==0.0.13.dev7
examples/fulltext_search/reqs.txt:pytidb==0.0.13.dev7
examples/rag/reqs.txt:pytidb==0.0.13.dev7
examples/image_search/reqs.txt:pytidb==0.0.13.dev7

Only these examples were correctly updated:

• examples/auto_embedding/reqs.txt ✅
• examples/vector_search/reqs.txt ✅

🔍 Minor Issues:

1. README Path Error: In examples/custom_embedding/README.md:27, the path references custom_embedding_function/ instead of custom_embedding/

2. Documentation Inconsistency: Some examples show better structured README files than others - consider standardizing the format

3. Missing GraphRAG Requirements: No reqs.txt file found for the new GraphRAG example

📋 Recommendations

1. Fix Version Consistency: Update all remaining reqs.txt files to use pytidb==0.0.13.dev8

2. Add Missing Files: Create examples/graphrag/reqs.txt with appropriate dependencies

3. Fix Documentation: Correct the path reference in the custom embedding README

4. Consider Testing: The new cursor rule suggests testing examples - consider adding a CI step to validate all examples work with the new version

🏗️ Technical Review

Core Changes:

• ✅ pytidb/embeddings/aliases.py: Clean model alias mapping
• ✅ pytidb/embeddings/builtin.py: Enhanced with better provider support
• ✅ pytidb/orm/ updates: Good type improvements

Example Quality:

• ✅ Custom embedding implementation follows best practices
• ✅ Proper separation between embedding logic and application code
• ✅ Good documentation and error handling
• ✅ Streamlit examples are well-structured

---

Verdict: This is a solid PR that adds valuable functionality, but the version inconsistency issues need to be addressed before merge to ensure all examples work correctly with the new version.

[Mini256]

@claude

[claude]

Claude finished @Mini256's task —— View job

---

Updated PR Review: pytidb version 0.0.13.dev8

Todo List:

• Read repository CLAUDE.md for guidelines
• Check current version consistency across reqs.txt files
• Verify status of issues from previous review
• Analyze any new changes since last review
• Provide comprehensive updated feedback

---

🎉 Excellent Progress - Major Issues Resolved!

The critical version inconsistency issue identified in the previous review has been completely resolved. All examples now correctly reference pytidb==0.0.13.dev8.

✅ Issues Fixed Since Last Review

🔧 Version Consistency ✅

All reqs.txt files now correctly reference version 0.0.13.dev8:

• examples/auto_embedding/reqs.txt ✅
• examples/basic/reqs.txt ✅
• examples/custom_embedding/reqs.txt ✅
• examples/fulltext_search/reqs.txt ✅
• examples/hybrid_search/reqs.txt ✅
• examples/image_search/reqs.txt ✅
• examples/memory/reqs.txt ✅
• examples/quickstart/reqs.txt ✅
• examples/rag/reqs.txt ✅
• examples/text2sql/reqs.txt ✅
• examples/vector_search/reqs.txt ✅

🗑️ GraphRAG Resolution ✅

The GraphRAG example was properly removed (commit f7137ab) rather than left incomplete, which resolves the missing requirements file concern.

📖 Custom Embedding Documentation ✅

The examples/custom_embedding/README.md path references are correct - the directory structure shows custom_embedding/ not custom_embedding_function/, so no path issues exist.

🔍 Current State Analysis

✅ Strong Points Maintained:

1. Comprehensive Version Update: Project version in pyproject.toml:3 matches all example requirements
2. High-Quality Custom Embedding: BGE-M3 implementation remains well-architected with proper error handling
3. Consistent Code Style: All examples maintain good practices and documentation
4. Complete Documentation: README files provide clear setup and usage instructions

✅ Technical Quality:

• Clean Dependencies: All reqs.txt files are properly formatted and consistent
• Proper Structure: Custom embedding example follows best practices
• Good Documentation: Comprehensive setup instructions with troubleshooting sections
• Version Alignment: Core library and all examples are synchronized

📊 File Analysis Summary:

Total Examples Analyzed: 11
Version Consistency: 11/11 ✅
Documentation Quality: High ✅
Code Structure: Clean and consistent ✅

🚀 Recommendation

This PR is now ready for merge! All critical issues from the previous review have been addressed:

• ✅ Version inconsistency resolved across all examples
• ✅ GraphRAG concerns addressed by proper removal
• ✅ Documentation paths are correct
• ✅ High code quality maintained throughout

The PR successfully updates the pytidb ecosystem to version 0.0.13.dev8 with comprehensive example updates and maintains excellent code quality standards.

---