Skip to content

Quick Start

Jump to bottom
Traliran edited this page Aug 12, 2026 · 3 revisions

🚀 Quick Start & Hosting Guide

Getting started with Traliran AI Hub is straightforward since there are no build dependencies or compilation steps required. You can use the hosted web app directly or deploy your own static instance in seconds.

1. Using the Hosted Version (Instant Access)

The easiest way to use Traliran AI Hub without setting up local hosting:

👉 Open Live App on GitHub Pages

  1. Open the link above in any modern browser.
  2. Navigate to Settings (Gear icon).
  3. Insert your desired provider's API key (or local endpoint URL like http://localhost:11434 for Ollama).
  4. Start chatting!

2. Running Locally on Your Machine

Because Traliran AI Hub uses pure HTML/JS/CSS, you don't need npm or yarn. However, opening index.html directly via the file:// protocol can cause browser restrictions (such as blocked Web Workers or local storage issues).

We recommend serving the files using any simple static HTTP server.

Option A: Python (Pre-installed on Linux/macOS)

Clone the repository and run Python's built-in HTTP server:

git clone https://github.com/traliran/traliran-ai-hub.git
cd traliran-ai-hub
python3 -m http.server 8080

Open http://localhost:8080 in your browser.

Option B: Caddy (Recommended for clean web servers)

caddy file-server --listen :8080

Option C: Node/NPX (If you already have Node installed)

npx servor . 8080

3. Self-Hosting / Deployment

You can host Traliran AI Hub on any static hosting platform for free.

GitHub Pages (Fork Deployment)

Fork the traliran-ai-hub repository to your GitHub account.

Go to Settings -> Pages in your fork.

Under Source, select Deploy from a branch.

Choose the main branch and / (root) folder, then click Save.

Your instance will be live at https://<your-username>.github.io/traliran-ai-hub/.

Nginx / Web Server

Simply point your document root to the cloned repository directory:

server {
    listen 80;
    server_name ai.yourdomain.com;
    root /var/www/traliran-ai-hub;
    index index.html;

    location / {
        try_files $uri$uri/ =404;
    }
}

⚠️ Important Note on HTTPS and Local LLMs (Mixed Content)

If you are accessing Traliran AI Hub via an HTTPS URL (like the official GitHub Pages deployment) and try to connect to a local HTTP endpoint (e.g., http://localhost:11434 for Ollama or http://127.0.0.1:8080 for llama.cpp), modern browsers will block the requests due to Mixed Content restrictions.

Solutions:

Run your local static instance over http://localhost:8080 (Browsers allow HTTP-to-HTTP local calls).

Or set up a reverse proxy with local TLS certificates for your local LLM service.

Clone this wiki locally