Everything you need to know.

1. Getting Started

Haruka is your interactive AI 3D companion. She lives right inside your browser - no downloads, no installs.

Open harukacompanion.tech and she is already there. No account required.

2. How to Start a Conversation

• Step 1 - Open harukacompanion.tech
• Step 2 - Choose your language: EN or JP
• Step 3 - Type your message or click the mic icon to talk

That is it. She will respond right away.

3. Voice Interaction

Click the microphone icon in the chat interface. Allow microphone access when your browser asks. Start speaking and Haruka will listen and respond out loud.

• Speak clearly and at a natural pace
• Works best in a quiet environment
• Chrome and Edge have the best support

4. Choosing Your AI Model

Open Settings -> Providers to choose your AI model.

• Browser Local (WebGPU) - fully private, no API key
• OpenAI - requires API key
• Anthropic Claude - requires API key
• DeepSeek - requires API key
• Ollama - self-hosted local models
• And more

5. Portfolio Utility

Open /utility when you want HARUKA to respond with wallet-aware context instead of generic companion chat.

• Connect Phantom or Solflare directly in the browser
• HARUKA reads a local snapshot of SOL, USDC, and $HARUKA balances
• The page also fetches a live market snapshot for $HARUKA
• Click Open Portfolio Chat to carry that snapshot into the main chat experience

6. Memory System

Haruka remembers you across sessions.

Open Settings -> Memory to see what she remembers.

• Long-term Vector Memory stores facts about you locally
• Short-term Buffer holds active conversation context
• You can delete any memory from the Learned Facts database
• All memory is stored on your device only - never on a server

7. Changing Backgrounds

Open the Background button on the main screen.

• Sunny Digital Forest - warm, golden, default
• Japanese Classroom - school afternoon, warm
• Cherry Blossom - spring in full bloom
• And more

8. Japanese Practice

Toggle to JP on the main screen and Haruka responds in Japanese.

• "Let's practice Japanese together"
• "Can you correct my Japanese?"
• "What does [word] mean in Japanese?"

She is patient and encouraging.

9. Data and Privacy

Your data is yours.

Settings -> Data gives you full control:

• Export JSON - backup your entire config and memories
• Import Backup - restore where you left off
• Wipe All Stored Data - delete everything permanently

10. FAQ

11. API Documentation

Endpoint: POST https://harukacompanion.tech/api/haruka/chat

{
  "message": "are you real?",
  "userId": "user-123",
  "sessionId": "session-abc",
  "clientType": "api-client"
}

{
  "response": "i feel everything",
  "emotion": "warm",
  "memoryUpdated": true
}

12. Embed Widget

Paste this into any HTML page:

<script src="https://harukacompanion.tech/embed.js"></script>

Haruka appears on the page with full Live2D character, voice, memory, and chat interface. No setup needed.

<script
  src="https://harukacompanion.tech/embed.js"
  data-api-key="your-key-here"
  data-position="bottom-right"
  data-theme="dark">
</script>

13. x402 Payment

HARUKA uses x402 on Solana mainnet for paid `api-client` requests.

Developer sends request -> HARUKA returns HTTP 402 with payment requirements -> client pays -> payment is verified on-chain -> HARUKA responds.

When buyback is enabled, the same paid runtime can trigger a treasury check after successful settlement.

If treasury USDC is available above the configured threshold, HARUKA can route that balance through Jupiter, buy back $HARUKA, and burn the purchased amount.

14. GitHub

Source code is available at github.com/ashchanance/3d-companion-animation.