Hume API Examples

Browse sample code and projects designed to help you integrate Hume APIs

📘 Documentation • 💬 Join us on Discord • 🔐 Getting your API Keys

Overview

Welcome to the official Hume API Examples repository! Here you'll find open-source example projects and quickstart guides to help you integrate the Hume API across a variety of languages and frameworks.

Use these examples to:

• Add empathic Text-to-Speech (TTS) to your application
• Build rich conversational agents with the Empathic Voice Interface (EVI)
• Measure expressions with facial, vocal, and language-based analysis

Whether you're using Python, TypeScript, Swift, C#, Flutter, Unity, or Next.js, there's something here to help you get started quickly.

Text-to-Speech (TTS)

Name	Language	Framework
tts-dotnet-quickstart	C#	.NET
tts-next-js-agora	TypeScript	Next.js
tts-next-js-chat	TypeScript	Next.js
tts-next-js-vercel-ai-sdk	TypeScript	Next.js
tts-python-livekit	Python	LiveKit
tts-python-quickstart	Python
tts-swift-quickstart	Swift	iOS
tts-typescript-lipsync	TypeScript
tts-typescript-quickstart	TypeScript
tts-unity-quickstart	C#	Unity

Empathic Voice Interface (EVI)

Name	Language	Framework
evi-dotnet-quickstart	C#	.NET
evi-flutter	Dart	Flutter
evi-next-js-app-router-quickstart	TypeScript	Next.js
evi-next-js-function-calling	TypeScript	Next.js
evi-next-js-pages-router-quickstart	TypeScript	Next.js
evi-prompting-examples
evi-python-chat-history	Python
evi-python-clm-sse	Python
evi-python-clm-wss	Python
evi-python-control-plane	Python
evi-python-function-calling	Python
evi-python-phone-calling-proxy-server	Python	Flask
evi-python-quickstart	Python
evi-python-raw-api	Python
evi-python-webhooks	Python	FastAPI
evi-python-wss-clm-endpoint	Python	Modal
evi-react-native	TypeScript	React Native
evi-swift-chat	Swift	iOS
evi-touchdesigner	Python	TouchDesigner
evi-typescript-chat-history	TypeScript
evi-typescript-function-calling	TypeScript	Vite
evi-typescript-proxy	TypeScript	Node.js
evi-typescript-quickstart	TypeScript
evi-typescript-webhooks	TypeScript	Express
evi-unity-quickstart	C#	Unity
evi-vue-widget	TypeScript	Vue

Expression Measurement API

Name	Models	Language	Framework
visualization-example	face	Python
python-top-emotions	face	Python
typescript-raw-text-processor	language	TypeScript
next-js-emotional-language	language	TypeScript	Next.js
next-js-streaming-example	language, face, burst, speech	TypeScript	Next.js

Authentication & Setup

You must authenticate to use the Hume API. Your API key can be retrieved from the Hume AI platform. For detailed instructions, see our documentation on getting your api keys.

Each example project includes a README.md file with step-by-step instructions on:

• Setting your API key (usually via environment variables)
• Installing dependencies
• Running the example

License

All projects are licensed under the MIT License - see the LICENSE.txt file for details.