https://github.com/snowztech/helia
Open-source AI assistant for small businesses. Upload your docs, plug in your APIs, drop one script tag.
https://github.com/snowztech/helia
ai ai-agents assistant chatbot harness llm nextjs open-source openai rag rag-chatbot typescript
Last synced: 23 days ago
JSON representation
Open-source AI assistant for small businesses. Upload your docs, plug in your APIs, drop one script tag.
- Host: GitHub
- URL: https://github.com/snowztech/helia
- Owner: snowztech
- License: agpl-3.0
- Created: 2026-05-21T02:05:35.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-02T22:41:05.000Z (about 1 month ago)
- Last Synced: 2026-06-03T00:21:02.171Z (about 1 month ago)
- Topics: ai, ai-agents, assistant, chatbot, harness, llm, nextjs, open-source, openai, rag, rag-chatbot, typescript
- Language: TypeScript
- Homepage: https://gethelia.dev
- Size: 1.17 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Helia
> Open-source AI assistant for small businesses. Upload your docs, plug in
> your APIs, drop one script tag.
## Quick start
The same three commands work on your laptop or on any Linux server with
Docker installed. No Node or pnpm needed on the host.
```bash
git clone https://github.com/snowztech/helia
cd helia
cp .env.example .env
```
Open `.env` and fill the two required values:
```bash
OPENAI_API_KEY=sk-...
MASTER_KEY=$(openssl rand -hex 32)
```
Then bring up the stack:
```bash
docker compose up -d
```
First boot takes ~30 seconds. When the api logs say `helia-api listening`,
open **http://localhost:3000** in your browser.
```bash
docker compose logs -f api # watch boot
docker compose down # stop, keep data
docker compose down -v # stop and wipe the database
```
## What you can do
The admin has five pages:
| Page | What it does |
| ----------- | ------------------------------------------------------------------------------------------------- |
| `/` | Dashboard: messages this week, today, avg response, recent activity, getting-started checklist |
| `/sources` | Add knowledge: PDFs, plain text, or crawl a URL |
| `/tools` | Register HTTP endpoints the agent can call mid-conversation |
| `/widget` | Brand the widget, see it live, copy the install snippet |
| `/settings` | Workspace name, locale, model, API key status, allowed origins, user identity for logged-in users |
Gear icon (top right) → `/settings`. Theme toggle (top right) → dark/light.
## Embed the widget on your site
Once you've configured the bot, `/widget` shows your install snippet:
```html
```
Paste it before `