Interakt

Interakt is an open-source, self-hosted solution designed to enhance websites with powerful search capabilities and AI-driven chat functionalities, all grounded in user-specific data. This comprehensive tool allows users to effortlessly integrate a search box and chat interface into their websites without extensive setup; simply configure your data and customize interactions through the intuitive admin dashboard.

Core Features

• Intent-Driven Search: Leverage a sophisticated search engine that understands user intent through keyword, semantic or hybrid queries, complete with facets, autocomplete, synonyms, and AI-based query understanding.
• Knowledgeable Chat Interface: Engage users with a chat experience that references your indexed data, providing accurate responses and optional citations, all while maintaining focus on relevant topics.
• Insightful Analytics: Gain valuable insights through analytics that record search events and chat sessions, all housed in a dedicated analytics database, allowing for a comprehensive understanding of user engagement.

Demonstration Videos

Explore the full potential of Interakt through various demonstration videos:

• Backend Setup: From Git Clone to Localhost
• AI Search and Sales Assistant Integration with Medusa
• Admin Management of Medusa Integration

Innovative Highlights

Interakt seamlessly integrates numerous advanced features:

• 🔍 Hybrid Search: Combines keyword and vector-based results using Elasticsearch, supporting facets, sorting, and synonyms per index.
• 💬 Grounded Chat: Delivers responses using a deterministic pipeline, ensuring reliable results with inline citations.
• 🧩 Custom Tools Integration: Supports HTTP custom tools and connects to MCP servers via Streamable HTTP or SSE.
• 🧠 Model Flexibility: Compatible with various AI models, including OpenAI, Ollama, or custom endpoints.
• 📦 Simple Integration Widgets: Easily embed drop-in widgets on any website, requiring no specific framework.
• 📝 Versioned Prompts: Create editable templates with version control to fine-tune behavior without redeploying.
• 🛡️ Security Measures: Implement credential management and access controls with read-only tokens for public access.
• 🏠 Self-hosting Capability: Run on any Docker-compatible system using a streamlined setup with Postgres and Elasticsearch.

Architecture Overview

Interakt is designed for efficient functionality:

flowchart LR
  D["Your data<br/>catalog · docs · CMS · files"] --> IX["Search index"]
  IX --> SE["Search experience"]
  IX -- "tools" --> AE["AI chat experience"]
  T["Custom HTTP tools · MCP servers"] --> AE
  SE --> W["Widgets · REST API"]
  AE --> W
  W --> Y["Your website"]
  IX -.-> ES[("Elasticsearch or<br/>Azure AI Search")]
  AE -.-> LLM[("OpenAI · Ollama")]

Connect a data source, develop a robust search index, and create tailored experiences on top of that index, with chat interactions drawing data directly from it.

Quick Start Instructions

To get started with Interakt, ensure Node.js 24 and Docker are installed, then clone the repository and set it up as follows:

git clone https://github.com/alphasolutionsrepo/interakt.git
cd interakt/backend

cp .env.example .env  # fill in the generated secrets
cp setup/setup.config.example.yaml setup/setup.config.yaml  # configure your admin credentials

npm install
npm run infra:up  # start Docker containers
npm run dev  # migrate and setup the admin user

Access the admin panel at http://localhost:3000 to initiate setup steps and integrate an AI provider.

Embedding and API Usage

For embedding chat functionality:

<div id="chat"></div>
<script src="https://your-interakt-host/embed/v1/widgets.js"></script>
<script>
  window.ChatDropinUI.init({
    containerId: 'chat',
    accessToken: '<access token from the admin UI>',
  });
</script>

Or utilize the API for programmatic access:

# Search API example
curl -X POST https://your-interakt-host/api/v1/search/<experience-slug>/search \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "query": "waterproof trail shoes" }'

# Chat API example
curl -N -X POST https://your-interakt-host/api/v1/ai-experiences/<experience-slug>/chat \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Which of these run true to size?" }'

Comprehensive documentation is available for further guidance on usage and integration with various platforms.