Skip to content

nitishagar/sober-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SoberAI Optimizer

License: MIT Node.js Version GitHub Issues GitHub Stars Version CI

sober-ai(2)

Lighthouse for the AI Age - A free, open-source website auditing tool that evaluates and optimizes websites for AI agent interactions.

Overview

With 1 billion+ monthly AI crawler requests (GPTBot, ClaudeBot, PerplexityBot), optimizing for AI visibility is no longer optional. SoberAI is the first specialized tool for ensuring your website works perfectly with AI agents, LLMs, and autonomous browsing systems.

What It Audits

Category Weight Description
SSR Readiness 25% Server-side rendering for AI agents that don't execute JavaScript
Schema Coverage 20% Structured data (Schema.org) for AI understanding
Semantic Structure 20% HTML5 semantic elements and heading hierarchy
Content Extractability 20% Text readability and accessibility for LLMs

AI-powered recommendations are generated using your choice of LLM provider (Ollama or OpenAI).

Quick Start

Option 1: Desktop App

Download the latest release for your platform from the Releases page.

Option 2: From Source

# Clone and install
git clone https://github.com/nitishagar/sober-ai.git
cd sober-ai
npm install

# Build frontend
cd frontend && npm install && npm run build && cd ..

# Set up database
npx prisma generate --schema=src/db/schema.prisma
npx prisma migrate deploy --schema=src/db/schema.prisma

# Start the server
node src/api/server.js
# Open http://localhost:3000

Option 3: Electron Development

npm run electron:dev

LLM Setup (Optional)

For AI-powered recommendations, install Ollama and pull a model:

ollama pull qwen3:4b

Or configure OpenAI in Settings with your API key.

Usage

  1. Navigate to the Audit page
  2. Enter a URL (e.g., https://vercel.com)
  3. Click Run Audit and watch real-time progress
  4. Review scores, findings, and AI recommendations
  5. Configure your LLM provider in Settings

Architecture

Electron Shell
├── React Frontend (BrowserWindow)
├── Express.js Backend (in-process)
├── SQLite Database (Prisma ORM)
├── Playwright (browser automation)
└── LLM Provider (Ollama local/cloud or OpenAI)

Key Technologies

  • Desktop: Electron
  • Backend: Express.js + Node.js 22+
  • Frontend: React + Vite
  • Database: SQLite via Prisma
  • Browser: Playwright
  • LLM: Ollama (local/cloud) or OpenAI

Testing

npm test          # Run all tests
npm run verify    # Run tests + lint

Documentation

Full documentation available at nitishagar.github.io/sober-ai.

Contributing

We welcome contributions! See the Contributing Guide for development setup and guidelines.

License

MIT License - see LICENSE for details.

Copyright 2025-2026 Nitish Agarwal

Support


Version 0.3.0 | Changelog

About

Lighthouse reimagined for the AI-first world

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors