HumeAI/hume-python-sdk

🧠 SDK Python chính thức của Hume AI — Kết nối AI cảm xúc vào ứng dụng

Tích hợp API phân tích cảm xúc EVI và TTS của Hume AI trực tiếp vào Python với client đồng bộ và bất đồng bộ, hỗ trợ WebSocket, phân trang và retry tự động.

Hume AI Python SDK là công cụ chính thức từ Hume AI giúp các nhà phát triển dễ dàng gọi các dịch vụ AI như Empathic Voice Interface (EVI) — giao diện giọng nói đọng cảm xúc — và Text-to-Speech (TTS) ngay trong mã nguồn Python. SDK hỗ trợ cả client đồng bộ (HumeClient) lẫn bất đồng bộ (AsyncHumeClient), phù hợp với cả dự án nhỏ lẫn hệ thống lớn.

✨ Điểm nổi bật

• Client đồng bộ và bất động: Hỗ trợ cả HumeClient và AsyncHumeClient để phù hợp với mọi kiểu ứng dụng.
• Hỗ trợ WebSocket: Giao tiếp thời gian thực với EVI thông qua WebSocket client tích hợp sẵn.
• Retry tự động: Tự động thử lại yêu cầu khi gặp lỗi mạng hoặc quá tải server (HTTP 408, 409, 429, 5xx).
• Phân trang thông minh: Trả về SyncPager hoặc AsyncPager, hỗ trợ lặp từng phần tử hoặc từng trang dễ dàng.
• Xử lý lỗi rõ ràng: Tất cả lỗi đều là lớp con của ApiError, dễ dàng bắt và xử lý.
• Hỗ trợ đa nền tảng: Tương thích với Python từ 3.9 đến 3.13 trên macOS, Linux và Windows.
• Cài đặt đa dạng: Hỗ trợ cài đặt qua pip, poetry và uv.

💡 Vì sao đáng chú ý

Khác với cách tích hợp API thủ công bằng requests, SDK này cung cấp cấu trúc namespace rõ ràng (client.empathic_voice, client.tts), giúp dễ dàng mở rộng và quản lý mã nguồn. Ngoài ra, việc hỗ trợ cả đồng bộ và bất đồng bộ giúp SDK linh hoạt vận dụng trong cả ứng dụng web nhẹ và hệ thống thời gian thực phức tạp.

#HumeAI #PythonSDK #AI #EmotionAnalysis #TTS #EVI #TextToSpeech #VoiceAI #TiniX