Skip to content

Pouryaak/lokul

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

281 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Lokul Logo

๐Ÿ”ฅ Lokul

Your AI. Your browser. Your privacy.

ChatGPT-quality AI running 100% in your browser. No servers. No tracking. Works offline.

GitHub stars License Made with Love

TypeScript React WebGPU Vite

Try Demo โ†’ โ€ข Documentation โ€ข Discord โ€ข Twitter

Lokul Demo

๐Ÿ’ก Replace demo.gif above with your actual demo showing: Chat working โ†’ Disconnect WiFi โ†’ Still works perfectly


๐ŸŽฏ The Problem

Every conversation with ChatGPT trains their models. Every prompt with Claude lives on Anthropic's servers. Every question costs you $20/month.

We think AI should be different.


โœจ Why Lokul?

๐Ÿ”’ Completely Private

Your conversations never leave your device. Not encrypted. Not anonymized. Just... never sent.

No company can see your data. No AI can train on your prompts. True privacy by architecture.

โœˆ๏ธ Works Offline

Download once, use forever.

Write on flights. Code at the beach. Work in basements. Study in libraries.

No internet? No problem.

๐Ÿ’ฐ Free Forever

No subscriptions. No API costs. No hidden fees.

The models are free. The code is free. Zero cost. Forever.

๐Ÿ”“ Open Source

Every line of code is public. Audit it yourself. Fork it. Modify it.

No trust required. Verify everything.


๐Ÿš€ Quick Start

Try It Now (No Installation)

# Just visit the demo
https://trylokul.com

# First time: ~30 second setup
# After that: Works forever, even offline

No account. No download. Just works.


๐ŸŽฌ See It In Action

๐Ÿ“ถ With Internet

Online Demo

Normal chat, everything works smoothly


โœˆ๏ธ Airplane Mode ON

Offline Demo

Still works perfectly. Zero internet.


That's the power of local AI.


๐ŸŽฏ Features

Feature Description
๐Ÿค– Multiple AI Models Choose between Quick (80MB), Smart (2.8GB), or Genius (6.4GB)
๐Ÿ’ฌ ChatGPT-Style Interface Familiar, clean, fast - just start chatting
๐Ÿ“ฆ Everything Local Models, conversations, settings - all on your device
๐Ÿ”„ Works Offline After first download, internet is optional
๐ŸŽจ Clean UX No clutter, just AI assistance
๐Ÿ›ก๏ธ Privacy First Zero data collection, zero analytics
โšก GPU Accelerated Uses WebGPU for instant responses
๐Ÿ’พ Auto-Save Never lose a conversation
๐ŸŽญ Memory System Remembers context across long chats
๐Ÿ“ฑ Progressive Web App Add to home screen, works like a native app

๐Ÿ“Š Lokul vs ChatGPT

Feature ChatGPT Plus Lokul
Privacy โŒ Cloud (your data on their servers) โœ… 100% Local (never leaves your device)
Offline โŒ No (needs internet) โœ… Yes (works on airplanes)
Cost โŒ $20/month ($240/year) โœ… Free ($0 forever)
Speed โš ๏ธ Network latency โœ… Instant (runs on your GPU)
Open Source โŒ No (black box) โœ… Yes (audit it yourself)
Data Training โŒ Your data trains their AI โœ… Never (stays local)
Downtime โš ๏ธ Can go offline โœ… Never (no server to crash)

๐Ÿ—๏ธ How It Works

graph LR
    A[๐ŸŒ Visit Lokul] --> B[โฌ‡๏ธ Download AI Model]
    B --> C[๐Ÿ’พ Cache Locally]
    C --> D[๐ŸŽฎ Run on Your GPU]
    D --> E[๐Ÿ’ฌ Chat Offline]
    E --> F[๐Ÿ”’ Everything Stays Local]

    style A fill:#FF6B35,stroke:#FFB84D,stroke-width:2px,color:#fff
    style B fill:#FF8C42,stroke:#FFB84D,stroke-width:2px,color:#fff
    style C fill:#FFB84D,stroke:#FF6B35,stroke-width:2px,color:#fff
    style D fill:#FF6B35,stroke:#FFB84D,stroke-width:2px,color:#fff
    style E fill:#FF8C42,stroke:#FFB84D,stroke-width:2px,color:#fff
    style F fill:#10B981,stroke:#059669,stroke-width:3px,color:#fff
Loading

The Technical Magic

  1. ๐ŸŒ Visit Lokul - Opens in your browser (Chrome/Edge)
  2. โฌ‡๏ธ Download Model - One-time download, cached forever
  3. ๐ŸŽฎ GPU Acceleration - Runs on your graphics card via WebGPU
  4. ๐Ÿ’พ Local Storage - Everything saved in IndexedDB
  5. โœˆ๏ธ Offline Ready - Works without internet after first load

Tech Stack:


๐Ÿ’ป Installation & Development

Prerequisites

Node.js 18+ (LTS recommended)
npm or pnpm
Chrome 113+ or Edge 113+ (for WebGPU support)

Local Development

# Clone the repository
git clone https://github.com/pouryaak/lokul.git

# Navigate to directory
cd lokul

# Install dependencies
npm install

# Start development server
npm run dev

# Open browser to http://localhost:5173

Build for Production

# Build optimized production bundle
npm run build

# Preview production build
npm run preview

๐ŸŽจ Screenshots

Light Mode

Light Mode

Dark Mode

Dark Mode

Model Selector

Model Selector

Performance Panel

Performance

๐Ÿ—บ๏ธ Roadmap

โœ… v1.0 (Current)

  • ChatGPT-style interface
  • Multiple AI models (Quick/Smart/Genius)
  • Works 100% offline
  • Performance monitoring
  • Memory system
  • Auto-save conversations

๐Ÿšง v1.1 (Coming Soon)

  • Search conversations
  • Better markdown rendering
  • Keyboard shortcuts
  • Export improvements
  • Mobile optimization

๐Ÿ”ฎ v1.5 (Planned)

  • Document upload (PDF support)
  • Custom system prompts
  • Conversation folders
  • Advanced memory management

๐ŸŒŸ v2.0 (Future)

  • Personal AIs (custom personas)
  • Project workspaces
  • Image understanding
  • Voice input/output

View Full Roadmap โ†’


๐Ÿค Contributing

We love contributions! Whether it's:

  • ๐Ÿ› Bug reports
  • โœจ Feature requests
  • ๐Ÿ“ Documentation improvements
  • ๐Ÿ”ง Code contributions

All are welcome!

How to Contribute

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Good First Issues

Looking for a place to start? Check out our good first issues.


๐Ÿ› Bug Reports & Feature Requests

Found a bug? Have an idea? We want to hear it!


๐Ÿ“š Documentation


๐Ÿ’ฌ Community

Join our growing community:

Discord Twitter GitHub Discussions


๐Ÿ™ Acknowledgments

Lokul stands on the shoulders of giants:


๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License - You can do whatever you want with this code!

โญ Star History

Star History Chart


๐Ÿ” Privacy & Security

Our Promise

  • โœ… Zero data collection - We literally can't see your data
  • โœ… No analytics - Not even anonymous usage stats
  • โœ… No tracking - No cookies, no fingerprinting
  • โœ… Open source - Verify everything yourself

How to Verify

  1. Open browser DevTools (F12)
  2. Go to Network tab
  3. Use Lokul
  4. Watch: Zero network requests

Your conversations never leave your browser. We can prove it.


โ“ FAQ

Is it really free? What's the catch?

Yes, actually free. No catch.

The AI models (Phi, Llama, Mistral) are open source and free to use. The code is open source and free to use. There's no server to pay for (because there is no server).

We might add optional premium features later (like cloud sync), but the core will always be free.

How good is it compared to ChatGPT?

Honest answer: It depends.

  • Quick Mode: Good for simple questions, faster than ChatGPT
  • Smart Mode: Comparable to ChatGPT 3.5 for most tasks
  • Genius Mode: Approaching ChatGPT 4 quality

The gap is closing fast. And unlike ChatGPT:

  • โœ… Works offline
  • โœ… Costs $0
  • โœ… Doesn't train on your data
Will this work on my device?

If you have:

  • Chrome 113+ or Edge 113+
  • 4GB+ available RAM
  • A modern graphics card (even integrated)

Then yes, it'll work.

Try Quick Mode first (works on almost anything). Smart Mode needs more power.

Can you see my conversations?

No. And we can prove it.

  1. Open browser dev tools (F12)
  2. Go to Network tab
  3. Use Lokul
  4. Watch: Zero network requests

Your conversations never leave your browser. We literally can't see them.

Plus, we're open source. Audit the code yourself.

Is this legal?

Yes! 100% legal.

The models we use are open source and licensed for commercial use:

  • Phi (Microsoft - MIT License)
  • Llama (Meta - Llama License)
  • Mistral (Mistral AI - Apache 2.0)

This is how open source is supposed to work.


๐Ÿ’– Support the Project

If you find Lokul useful, consider:

  • โญ Starring this repo - Helps others discover it
  • ๐Ÿฆ Sharing on Twitter - Spread the word
  • ๐Ÿ› Reporting bugs - Help us improve
  • ๐Ÿ’ป Contributing code - Make it better
  • ๐Ÿ“ Writing about it - Blog posts, videos, tutorials

Every bit helps!


Built with โค๏ธ for Privacy

Made by Pourya Ak

If you believe AI should be private, give us a star โญ

โฌ† Back to Top


ยฉ 2026 Lokul. Open source under MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors