Vane

Installation

There are mainly 2 ways of installing Vane - With Docker, Without Docker. Using Docker is highly recommended.

Getting Started with Docker (Recommended)

Vane can be easily run using Docker. Simply run the following command:

docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest

This will pull and start the Vane container with the bundled SearxNG search engine. Once running, open your browser and navigate to http://localhost:3000. You can then configure your settings (API keys, models, etc.) directly in the setup screen.

Note: The image includes both Vane and SearxNG, so no additional setup is required. The -v flags create persistent volumes for your data and uploaded files.

Using Vane with Your Own SearxNG Instance

If you already have SearxNG running, you can use the slim version of Vane:

docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latest

Important: Make sure your SearxNG instance has:

• JSON format enabled in the settings
• Wolfram Alpha search engine enabled

Replace http://your-searxng-url:8080 with your actual SearxNG URL. Then configure your AI provider settings in the setup screen at http://localhost:3000.

Advanced Setup (Building from Source)

If you prefer to build from source or need more control:

1. Ensure Docker is installed and running on your system.

2. Clone the Vane repository:

   git clone https://github.com/ItzCrazyKns/Vane.git
   

3. After cloning, navigate to the directory containing the project files.

4. Build and run using Docker:

   docker build -t vane .
   docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vane
   

5. Access Vane at http://localhost:3000 and configure your settings in the setup screen.

Note: After the containers are built, you can start Vane directly from Docker without having to open a terminal.

Non-Docker Installation

1. Install SearXNG and allow JSON format in the SearXNG settings. Make sure Wolfram Alpha search engine is also enabled.

2. Clone the repository:

   git clone https://github.com/ItzCrazyKns/Vane.git
   cd Vane
   

3. Install dependencies:

   npm i
   

4. Build the application:

   npm run build
   

5. Start the application:

   npm run start
   

6. Open your browser and navigate to http://localhost:3000 to complete the setup and configure your settings (API keys, models, SearxNG URL, etc.) in the setup screen.

Note: Using Docker is recommended as it simplifies the setup process, especially for managing environment variables and dependencies.

See the installation documentation for more information like updating, etc.