uncloseai.
uncloseai.js - Add AI to Any Website
uncloseai.js - Client-Side AI for Everyone
uncloseai.js is a lightweight JavaScript library that adds a floating AI chat button to any website. With just one line of code, you can integrate Hermes AI directly into your site - no server required, no backend needed.
This is a web client-only solution that works with static sites, CDNs, GitHub Pages, and any hosting platform that serves HTML. Add AI capabilities to your documentation, blog, portfolio, or any web page instantly.
✨ One-Line Installation
Add this script tag to your HTML to get the same floating AI button on your site:
<script src="https://uncloseai.com/uncloseai.js" type="module"></script>
That's it! A floating "uncloseai." button will appear in the bottom right corner of your page.
🎯 Features
- Zero Configuration - Works out of the box with sensible defaults
- No Server Required - Pure client-side JavaScript, runs entirely in the browser
- Streaming Responses - Real-time AI responses with smooth typewriter effect
- Mobile Friendly - Responsive design that works on all screen sizes
- Customizable - Control styling, positioning, and behavior via JavaScript variables
- Free & Open Source - Public domain software, use anywhere for any purpose
📖 Basic Usage
Once you've added the script tag, the floating button appears automatically. Click it to open the chat interface and start conversing with Hermes AI.
The chat interface includes:
- A textarea for your message input
- A send button to submit your question
- Real-time streaming responses from the AI
- Auto-scrolling to keep the latest message in view
- Mobile-responsive design that adapts to screen size
⚙️ Customization
You can customize the behavior and appearance of uncloseai.js by setting global variables before loading the script:
<script>
// Disable custom styling to use your site's CSS framework (e.g., PicoCSS)
window.UNCLOSEAI_CUSTOM_STYLING = false;
// Change the API endpoint (advanced)
window.UNCLOSEAI_BASE_URL = "https://hermes.ai.unturf.com/v1";
// Change the model (advanced)
window.UNCLOSEAI_MODEL = "adamo1139/Hermes-3-Llama-3.1-8B-FP8-Dynamic";
</script>
<script src="https://uncloseai.com/uncloseai.js" type="module"></script>
Available Configuration Options:
Variable | Default | Description |
---|---|---|
UNCLOSEAI_CUSTOM_STYLING |
true |
Enable/disable built-in styling. Set to false to use your site's CSS framework. |
UNCLOSEAI_BASE_URL |
https://hermes.ai.unturf.com/v1 |
API endpoint URL for chat completions |
UNCLOSEAI_MODEL |
adamo1139/Hermes-3-Llama-3.1-8B-FP8-Dynamic |
AI model identifier |
🎮 Try It Now
This page has uncloseai.js installed. Look for the floating "uncloseai." button in the bottom right corner of your screen and click it to start chatting with Hermes AI!
Example prompts to try:
- "Explain quantum computing in simple terms"
- "Write a JavaScript function to reverse a string"
- "What are the key principles of responsive web design?"
- "Generate a creative short story about a robot learning to paint"
Use Cases
uncloseai.js is perfect for:
- Documentation sites - Let users ask questions about your docs
- Personal blogs - Add an AI assistant to engage with readers
- Portfolios - Showcase AI integration skills
- Static sites - Add dynamic AI features without a backend
- Educational content - Provide interactive AI tutoring
- Landing pages - Answer visitor questions instantly
Technical Details
uncloseai.js uses:
- ES6 Modules - Modern JavaScript with
type="module"
- Fetch API - For streaming server-sent events (SSE)
- ReadableStream - For processing streaming responses
- CSS Variables - For easy theme customization
- Responsive Design - Mobile-first approach with media queries
Open Source
uncloseai.js is public domain software - completely free to use, modify, and distribute. No attribution required, though always appreciated!
📦 Source Code: https://git.unturf.com/engineering/unturf/uncloseai.com