Libre Assistant

Libre Assistant is a free, unlimited AI Chatbot that uses various models through Hack Club's free API. Libre Assistant does not sell or store user information, and all chat & user data is stored on your device.

Features

• All data is stored locally on your device. No data is stored on the internet.
• Full Markdown & LaTeX Support.
• Image generation support
• Document upload support
• Detailed code-blocks, including syntax highlighting, downloading, and a copy button.
• Customizable with name, occupation, and custom instructions.
• Free web search tools through search.hackclub.com.
• Reasoning effort customizability.
• Incognito mode to prevent chat history from being saved.
• Global memory to remember user details/preferences/opinions across chats.
• Parameter configuration panel with temperature, top_p, seed options, and a web search toggle.
• Conversation branching with message editing/regenerating

Todo

• Canvas/Code Panel
• Tree-of-Thought (Multiple instances of the same or different models working together to solve a problem at the same time)

Please suggest more ideas in the Issues tab.

VSCode Setup

VSCode.

Clone Project and Move into Its Folder

git clone https://github.com/Mostlime12195/Libre-Assistant.git
cd libre-assistant

Set Environment Variables

NUXT_PUBLIC_TURNSTILE_SITE_KEY
NUXT_TURNSTILE_SECRET_KEY
NUXT_SESSION_SECRET
NUXT_HACKCLUB_API_KEY
NUXT_HACKCLUB_SEARCH_API_KEY

NUXT_PUBLIC_TURNSTILE_SITE_KEY, NUXT_TURNSTILE_SECRET_KEY, and NUXT_SESSION_SECRET are required for Cloudflare's turnstile to work, but are optional.

NUXT_HACKCLUB_API_KEY is the default API key that will be used for all inference from ai.hackclub.com.

NUXT_HACKCLUB_SEARCH_API_KEY is the API key that will be used for all search tools from search.hacklub.com.

Install Dependencies

npm install

Compile and Hot-Reload for Development

npm run dev

Compile and Minify for Production

npm run build

Versioning

This project uses Semantic Versioning.

To update the version, use npm version commands:

# Bump the patch version (x.y.z -> x.y.z+1)
npm version patch

# Bump the minor version (x.y.z -> x.y+1.0)
npm version minor

# Bump the major version (x.y.z -> x+1.0.0)
npm version major

# Or set an explicit version
npm version 1.2.3

All notable changes to this project are documented in the CHANGELOG.md file.