Perplexica/README.md

BizSearch

A tool for finding and analyzing local businesses using AI-powered data extraction.

Prerequisites

• Node.js 16+
• Ollama (for local LLM)
• SearxNG instance

Installation

1. Install Ollama:

# On macOS
brew install ollama

2. Start Ollama:

# Start and enable on login
brew services start ollama

# Or run without auto-start
/usr/local/opt/ollama/bin/ollama serve

3. Pull the required model:

ollama pull mistral

4. Clone and set up the project:

git clone https://github.com/yourusername/bizsearch.git
cd bizsearch
npm install

5. Configure environment:

cp .env.example .env
# Edit .env with your settings

6. Start the application:

npm run dev

7. Open http://localhost:3000 in your browser

Troubleshooting

If Ollama fails to start:

# Stop any existing instance
brew services stop ollama
# Wait a few seconds
sleep 5
# Start again
brew services start ollama

To verify Ollama is running:

curl http://localhost:11434/api/version

Features

• Business search with location filtering
• Contact information extraction
• AI-powered data validation
• Clean, user-friendly interface
• Service health monitoring

Configuration

Key environment variables:

• SEARXNG_URL: Your SearxNG instance URL
• OLLAMA_URL: Ollama API endpoint (default: http://localhost:11434)
• SUPABASE_URL: Your Supabase project URL
• SUPABASE_ANON_KEY: Your Supabase anonymous key
• CACHE_DURATION_DAYS: How long to cache results (default: 7)

Supabase Setup

1. Create a new Supabase project
2. Run the SQL commands in db/init.sql to create the cache table
3. Copy your project URL and anon key to .env

License

MIT

Cache Management

The application uses Supabase for caching search results. Cache entries expire after 7 days.

Manual Cache Cleanup

If automatic cleanup is not available, you can manually clean up expired entries:

1. Using the API:

curl -X POST http://localhost:3000/api/cleanup

2. Using SQL:

select manual_cleanup();

Cache Statistics

View cache statistics using:

select * from cache_stats;