MCPcopy Index your code
hub / github.com/HumeAI/hume-api-examples

github.com/HumeAI/hume-api-examples @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
717 symbols 1,902 edges 227 files 130 documented · 18%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README


Hume API Examples

<strong>Browse sample code and projects designed to help you integrate Hume APIs</strong>






<a href="https://docs.hume.ai">📘 Documentation</a> •
<a href="https://discord.com/invite/humeai">💬 Join us on Discord</a> •
<a href="https://dev.hume.ai/docs/introduction/api-key">🔐 Getting your API Keys</a>

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)

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

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.

Extension points exported contracts — how you extend this code

Score (Interface)
* The code below does not pertain to the EVI implementation, and only serves to style the UI.
evi/evi-typescript-function-calling/src/main.ts
ButtonProps (Interface)
(no doc)
evi/evi-next-js-app-router-quickstart/components/ui/button.tsx
ButtonProps (Interface)
(no doc)
evi/evi-next-js-pages-router-quickstart/components/ui/button.tsx
ButtonProps (Interface)
(no doc)
evi/evi-next-js-function-calling/components/ui/button.tsx
VoiceIsolationModePromptProps (Interface)
(no doc)
evi/evi-react-native/VoiceIsolationModePrompt.tsx
AgoraTokenData (Interface)
(no doc)
tts/tts-next-js-agora/types/conversation.ts
Props (Interface)
(no doc)
tts/tts-next-js-chat/src/app/components/VoiceSelector.tsx
Clip (Interface)
(no doc)
tts/tts-next-js-vercel-ai-sdk/src/types/clip.ts

Core symbols most depended-on inside this repo

on
called by 43
tts/tts-next-js-agora/types/agora-rtc-react.d.ts
result
called by 33
evi/evi-typescript-proxy/app/main.ts
stop
called by 20
tts/tts-typescript-lipsync/mouth.ts
connect
called by 17
evi/evi-python-raw-api/src/connection.py
mirror
called by 15
tts/tts-typescript-lipsync/mouth.ts
close
called by 12
evi/evi-typescript-proxy/app/upstream.ts
send
called by 11
evi/evi-typescript-proxy/app/upstream.ts
abortable
called by 10
evi/evi-typescript-proxy/app/cli.ts

Shape

Function 370
Method 220
Class 73
Interface 41
Route 10
Enum 3

Languages

TypeScript56%
Python26%
C#17%
Kotlin1%

Modules by API surface

evi/evi-unity-quickstart/Assets/Scripts/HumeEVI.cs24 symbols
tts/tts-next-js-agora/lib/message.ts22 symbols
tts/tts-dotnet-quickstart/Program.cs21 symbols
evi/evi-typescript-proxy/app/upstream.ts20 symbols
evi/evi-unity-quickstart/Assets/Scripts/SceneBuilder.cs18 symbols
evi/evi-python-clm-wss/main.py18 symbols
evi/evi-typescript-function-calling/src/main.ts17 symbols
tts/tts-typescript-lipsync/mouth.ts16 symbols
tts/tts-python-quickstart/test_app.py16 symbols
tts/tts-next-js-agora/types/agora-rtc-react.d.ts14 symbols
evi/evi-typescript-proxy/app/cli.ts14 symbols
evi/evi-python-phone-calling-proxy-server/app.py14 symbols

For agents

$ claude mcp add hume-api-examples \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact