Oráculo Tainacan

AI-powered natural-language search and chat for Tainacan digital archives. RAG with multiple providers (OpenAI, Gemini, Claude, DeepSeek, Groq).

Description

Oráculo Tainacan adds Artificial Intelligence capabilities to Tainacan, enabling:

• Semantic Search (RAG): Find items by meaning, not just keywords
• AI Chat: Converse about the archive with conversation memory and extracted facts
• Vector Indexing: Generate embeddings for items to enable similarity search
• Multiple Providers: OpenAI, Google Gemini, Claude (Anthropic), DeepSeek, Groq and Ollama (local)
• Analytics: Track usage metrics, searches, feedback and performance
• Per-collection Prompts: Customizable system/search/chat prompts per collection
• Webhooks: Trigger external integrations on plugin events
• Export: Export conversations and analytics reports
• Multimodal Search: Search combining text and other signals
• Smart Suggestions: Dynamic suggested questions based on context
• WP-CLI: Commands for batch indexing, statistics and maintenance
• REST API: 20 endpoints under /wp-json/oraculo/v1

Requirements

• WordPress 6.0 or higher
• PHP 8.0 or higher
• Tainacan plugin 1.0+ installed and active (integration via Pages API)
• API key for at least one AI provider, or Ollama running locally

Installation

1. Upload the plugin via Plugins > Add New > Upload Plugin
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Tainacan > Oráculo AI in the admin menu
4. Configure your API key in the Settings tab
5. Index your collections in the Indexing tab

Configuration

1. Choose an AI Provider: OpenAI, Gemini, Claude, DeepSeek, Groq or Ollama
2. Configure the API Key: Enter the key for your chosen provider
3. Select the Model: Choose chat and embedding models
4. Adjust Parameters: Temperature, max tokens, similarity threshold, batch size
5. Enable Features: Chat, search, analytics and feedback can each be toggled individually

Usage

Shortcodes:

• [oraculo_search] - Semantic search widget
• [oraculo_chat] - AI chat widget

Search shortcode parameters:

• collection - Collection ID (optional; uses all collections if omitted)
• placeholder - Placeholder text for the search field
• show_suggestions - Show suggestions (true/false)

Example: [oraculo_search collection="123" placeholder="What are you looking for?" show_suggestions="true"]

CLI Commands

• wp oraculo index --collection=<id> - Index a collection
• wp oraculo reindex --all - Re-index all collections
• wp oraculo stats - Usage statistics
• wp oraculo clear-cache - Clear search cache

REST API

Namespace: /wp-json/oraculo/v1. Main routes:

• POST /search - Semantic search
• POST /chat - Chat message
• GET /conversations - List conversations
• POST /feedback - Record feedback
• POST /indexing/start - Start indexing
• GET /indexing/status - Indexing status
• GET /analytics - Aggregated metrics
• GET /providers - Available providers
• POST /providers/test - Test provider connection
• GET /health - Health check

Supported AI Providers

1. OpenAI - GPT-4o, GPT-4o-mini, GPT-3.5-turbo + text-embedding-ada-002/3
2. Google Gemini - gemini-1.5-flash, gemini-1.5-pro
3. Claude (Anthropic) - claude-3.5-sonnet, claude-3-opus/haiku
4. DeepSeek - deepseek-chat, deepseek-coder
5. Groq - llama-3.1-70b, mixtral-8x7b, gemma2-9b
6. Ollama - Any local model (full privacy; embeddings via nomic-embed-text)

Frequently Asked Questions

Does this plugin work without Tainacan?

No. Oráculo Tainacan is an add-on for the Tainacan digital archive plugin and requires Tainacan 1.0 or higher.

Which AI provider should I use?

OpenAI is the most tested option. Ollama is recommended for fully local, private deployments.

Is my data sent to third parties?

Only the text content of your archived items is sent to the AI provider you configure. When using Ollama, everything stays local.

Changelog

2.0.3

• Harden chat textarea color/background against theme resets

2.0.2

• Fix chat title color (h3) overridden by WordPress theme

2.0.1

• Fix text contrast issues in frontend and chat widget
• Fix invisible text in chat input (white on white)
• Fix invisible text in user messages (navy on navy)
• Fix chat header subtitle contrast (dark on dark)
• Improve placeholder and auxiliary text contrast to pass WCAG AA
• Fix invalid CSS declaration in search hero

2.0.0

• Complete rewrite with service-oriented architecture and PSR-4 namespaces
• Requires PHP 8.0 and WordPress 6.0
• Integration with Tainacan 1.0+ via Pages API (\Tainacan\Pages)
• New providers: Claude (Anthropic) and Groq
• Conversation memory with summaries and facts extracted per session
• Customizable prompts per collection
• Webhooks for external integrations
• Export of conversations and analytics
• Multimodal search and smart suggestions
• Expanded REST API (20 endpoints under /oraculo/v1)
• Redesigned admin dashboard with tabs (Dashboard, Analytics, Indexing, Settings, Debug)

1.0.0

• Initial release
• Semantic search with RAG
• Integrated AI chat
• Support for 4 AI providers
• Analytics dashboard
• Initial Tainacan integration

Upgrade Notice

2.0.1

Fixes accessibility contrast issues in frontend and chat. Update recommended.

2.0.0

Major rewrite. Requires PHP 8.0+, WordPress 6.0+ and Tainacan 1.0+. New tables are created automatically on activation; existing settings are preserved.