local-ai-stack  by ykhli

Starter kit for local-only AI apps, document Q&A focused

created 1 year ago
1,374 stars

Top 30.0% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a starter kit for building local-only AI applications, specifically focusing on document Q&A, with the primary benefit of zero running costs. It targets developers and users who want to experiment with and deploy AI functionalities without relying on cloud services or incurring expenses.

How It Works

The stack leverages a combination of open-source technologies for a fully local AI experience. Ollama handles model inference, Supabase with pgvector serves as the vector database, and Langchain.js orchestrates LLM interactions. Embeddings are generated using Transformer.js with the all-MiniLM-L6-v2 model, and the application logic is built with Next.js. This modular approach allows for easy substitution of components and ensures all processing occurs client-side or on the user's machine.

Quick Start & Requirements

  • Install dependencies: npm install
  • Install Ollama: Instructions
  • Run Supabase locally: supabase start (requires Supabase CLI, install via brew install supabase/tap/supabase)
  • Generate embeddings: node src/scripts/indexBlogLocal.mjs
  • Run app: npm run dev
  • Visit: http://localhost:3000

Highlighted Details

  • Enables 100% local AI applications with zero running costs.
  • Integrates Ollama for inference, Supabase/pgvector for vector storage, and Langchain.js for orchestration.
  • Utilizes Transformer.js and all-MiniLM-L6-v2 for local embedding generation.
  • Built with Next.js for application logic.

Maintenance & Community

  • Community support available via a #local-ai-stack channel on the AI Stack devs Discord.

Licensing & Compatibility

  • The repository does not explicitly state a license in the provided README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project is presented as a starter kit, implying it may require further development for production readiness. Specific limitations regarding supported operating systems, hardware requirements beyond local execution, or performance benchmarks are not detailed in the README.

Health Check
Last commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
13 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Taranjeet Singh Taranjeet Singh(Cofounder of Mem0), and
1 more.

fragments by e2b-dev

0.6%
6k
Next.js template for AI-generated apps
created 1 year ago
updated 1 week ago
Feedback? Help us improve.