Prathamesh Deshmukh
Kusanagi-AI Project Logo

Kusanagi-AI: Free & Open-Source Local AI Toolkit

Empowering researchers with accessible, privacy-focused AI tools designed to run efficiently on standard home laptops. Kusanagi-AI provides a robust, open-source platform for local AI experimentation, ensuring complete data ownership and control.

View on GitHub

About This Project

Kusanagi-AI was developed to address the growing need for accessible and privacy-conscious AI solutions within the research community. Our mission is to provide a free, open-source toolkit that enables researchers, especially those in Physics and Material Science, to leverage advanced AI capabilities directly on their personal computers. By focusing on local execution, Kusanagi-AI ensures complete data privacy and eliminates reliance on cloud services, making sophisticated AI analysis available without specialized hardware or extensive technical expertise. This project is a testament to the power of local AI, offering a controlled environment for deep learning and practical application.

Technology Stack

Python Logo

Python

The entire frontend and application logic are developed in Python, ensuring readability and a vast ecosystem of libraries.

Ollama Logo

Ollama

Powers local LLM inference, allowing Kusanagi-AI to run models like Llama3 and Gemma efficiently without cloud dependencies.

Mixedbread AI Logo

MXBAI Embeddings

Utilizes the `mxbai-embed-large` model for high-quality document embeddings, crucial for RAG and semantic search.

Features

Getting Started

Prerequisites

  • Python 3.8+: The core programming language.
  • Ollama: Essential for running local LLMs. Download from ollama.com.

Installation & Usage

1. Clone the repository:

git clone https://github.com/prathameshnium/Kusanagi-AI.git
cd Kusanagi-AI

2. Install dependencies (preferably in a virtual environment):

pip install -r requirements.txt

3. Configure `System_Config.json` with the correct paths for your Ollama executable and model folder.

4. Pull the required models via the Ollama CLI:

ollama pull mxbai-embed-large
ollama pull llama3

5. Launch the Research Assistant:

python Orochimaru_Local_Research_Assistent.py

License

This project is released under the MIT License.

Disclaimer

Kusanagi-AI is an open-source project for educational and research purposes, provided "as-is" without warranty.