v2.4Sign In
Python SDK
Installation
Install the official GuidedMind Python SDK — type-safe, async-capable, and production-ready.
$pip install guidedmind-rag-sdk-python
Requires Python 3.8+. All dependencies (httpx, pydantic v2, anyio) are installed automatically — no extra steps needed.
Requirements
| Package | Version | Notes |
|---|---|---|
| Python | 3.8+ | |
| httpx | ≥ 0.24 | HTTP client |
| pydantic | v2 | Type-safe data models |
| anyio | ≥ 3.0 | Async runtime compatibility |
| tenacity | ≥ 8.0 | Retry logic |
Key Features
- Type-safe interfaces — every request and response is validated by Pydantic v2 models, so you get IDE autocomplete and runtime safety.
- Async support — all methods have an async counterpart prefixed with
a(e.g.asearch(),aadd_record()). - Automatic retries — exponential backoff on 429 and 5xx errors up to
max_retriesattempts before raising. - Structured logging — API keys are automatically redacted in every log line and error message.
- HTTPS enforcement — the client refuses to connect over plaintext http base URLs at initialisation time.
- Unified client — one Client instance covers RAG search, Short Memory, Long Memory, and Document Management.
GitHub Repository
The SDK is fully open source under the MIT license.
Do
- Star the repo to track new releases
- Open issues for bugs or missing features
- Check CHANGELOG.md before upgrading
Don't
- Pin to a specific commit SHA in production
- Fork without opening an upstream PR