@@ -6,17 +6,17 @@ A web-based personal assistant that connects to local Ollama models for chat con
66
77 - ๐ฌ **Chat Interface**: Thread-based conversations with message history
88 - ๐ค **Ollama Integration**: Connect to local LLM models via Ollama
9-- ๐ ๏ธ **Tool Calling**: Built-in tools for weather, web search, DuckDuckGo, and page fetching
9+- ๐ง **Thinking Mode**: View model reasoning process with thinking output
10+- ๐ ๏ธ **Tool Calling**: Built-in tools for web search (SearXNG) and page fetching
1011 - ๐จ **Modern UI**: Clean, responsive interface with dark/light theme support
1112 - ๐พ **Persistent Storage**: PostgreSQL database for threads and messages
1213 - โก **Caching**: Valkey (Redis-compatible) caching for improved performance
13-- ๐ **Rate Limiting**: Built-in rate limiting for API calls
1414 - ๐ **Markdown Support**: Rich markdown rendering with syntax highlighting
1515
1616 ## Prerequisites
1717
1818 - Node.js >= 25.0.0
19-- Docker (for running PostgreSQL and Valkey)
19+- Docker (for running PostgreSQL, Valkey, and SearXNG)
2020 - Ollama installed and running locally
2121
2222 ## Getting Started
@@ -52,19 +52,24 @@ POSTGRES_USER=postgres
5252 POSTGRES_DB=personal_assistant
5353 POSTGRES_PORT=5432
5454
55-# Optional: Google Custom Search API (for web search tool)
56-GOOGLE_CUSTOM_SEARCH_API_KEY=your_api_key
57-GOOGLE_CUSTOM_SEARCH_ENGINE_ID=your_engine_id
55+# Optional: SearXNG URL (for web search tool, defaults to http://localhost:8888)
56+SEARXNG_URL=http://localhost:8888
5857 ```
5958
6059 ### 4. Start Docker Services
6160
62-The project includes scripts to start PostgreSQL and Valkey containers:
61+The project includes scripts to start PostgreSQL, Valkey, and SearXNG containers:
6362
6463 ```bash
6564 npm run start:docker
6665 ```
6766
67+This will start:
68+
69+- PostgreSQL database on port 5432
70+- Valkey (Redis-compatible) cache on port 6379
71+- SearXNG search engine on port 8888
72+
6873 To stop the containers:
6974
7075 ```bash
@@ -132,17 +137,18 @@ personal-assistant-thing/
132137 โ โโโ cache/ # Caching utilities
133138 โ โโโ ...
134139 โโโ drizzle/ # Database migrations
135-โโโ scripts/ # Utility scripts
140+โโโ scripts/ # Utility scripts
141+โโโ searxng/ # SearXNG configuration
136142 ```
137143
138144 ## Tools
139145
140146 The assistant supports the following tools:
141147
142-- **Weather**: Get current weather and forecasts
143-- **Web Search**: Search the web using Google Custom Search API
144-- **DuckDuckGo**: Search using DuckDuckGo
145-- **Fetch Page**: Fetch and extract content from web pages
148+- **Web Search**: Search the web using SearXNG (privacy-focused metasearch engine)
149+- **Fetch Page**: Fetch and extract content from web pages, including title, content, and links
150+
151+Both tools use caching to improve performance and reduce API calls.
146152
147153 ## Database Schema