ToolsWallet RAG documentation v1.0. Learn how to build custom knowledge assistants with zero cost. ToolsWallet Platform
DocumentationPlatform Overview
4 min readAugust 2026
v1.0 Production

ToolsWallet RAG Platform Overview

Try in Console

Standard AI models often guess or make up facts (hallucinate) when asked questions about your specific business data. ToolsWallet RAG solves this by connecting your private documents (JSON datasets, FAQs, policy notes, and guides) directly to high-speed AI inference. It searches your indexed records, pulls the exact matching facts, and generates precise, cited answers with zero guesswork.

Core Highlights & Guarantees
100% Free Developer Tier: Create up to 2 full Knowledge Bases (RAGs) with zero credit card required.
High-Speed Precision Search: Instant document search with SHA-256 deduplication and sub-50ms response.
Real-Time Token Streaming: Live typewriter SSE stream (`/api/v1/query/stream`) with sub-50ms initial response.
1-Line Drop-in Chat Widget: Paste a single `<script>` tag on any HTML, WordPress, or React website in 30 seconds.
Anti-Abuse Rate Protection: 10 RPM (Requests/Minute) and 100 RPD (Requests/Day) fair use protection.
VISUAL PLATFORM FLOW4 Simple Steps

How to Use ToolsWallet RAG

From raw documents to a live website AI chatbot in 3 minutes.

Launch Assistant
1SETUP

Create Assistant

Enter your Bot Name (e.g. 'Support Copilot') in Create Studio.

2INGEST

Add Knowledge

Upload a JSON file or paste FAQ text (up to 25 Records). Checked with SHA-256.

3SECURITY

Get API Key

Generate tw_rag_live_... and set CORS domain whitelist.

4DEPLOY

Deploy & Stream

Paste 1-line <script> on your site or call streaming REST API.

</>query_rag.py
1import requests
2
3# Initialize ToolsWallet RAG Query
4API_KEY = "tw_rag_live_YOUR_API_KEY"
5RAG_ID = "YOUR_RAG_ID"
6
7response = requests.post(
8 "http://localhost:8081/api/v1/query",
9 headers={
10 "Content-Type": "application/json",
11 "X-API-Key": API_KEY
12 },
13 json={
14 "ragId": RAG_ID,
15 "query": "What is our refund window for annual SaaS plans?"
16 }
17)
18
19result = response.json()
20print(f"Answer: {result.get('answer')}")
21print(f"Citations: {[s['sourceName'] for s in result.get('sources', [])]}")

What is ToolsWallet RAG?

Retrieval-Augmented Generation (RAG) is a technique that gives AI models access to your private company data before answering questions. ToolsWallet RAG provides a ready-to-use, zero-cost knowledge engine with instant ingestion and real-time streaming answers.

  • Instant Document Ingestion: Files and JSON data are parsed, deduplicated, and available for search in under 50 milliseconds.
  • Complete Grounding & Citations: Every answer shows the exact document names and text passages used to build the answer.
  • Zero Hallucinations: The AI assistant strictly confines its answers to your verified knowledge base.

How to Use the System (4-Step Flow)

Any user or developer can set up an AI assistant in 4 simple steps:

  • Step 1 (Create Knowledge Base): Go to /dashboard/create and enter a bot name (e.g. 'Customer Support Bot').
  • Step 2 (Add Knowledge): Upload a .json/.txt/.md file or paste text snippets (up to 25 records per RAG).
  • Step 3 (Get API Key): Go to API Keys tab to generate a secure live key and whitelist your website domain.
  • Step 4 (Deploy): Paste the 1-line <script> tag on your website or call POST /api/v1/query/stream from your code.

Understanding Sources vs Records

To keep things simple and clear, our system uses two basic terms:

  • Source (File / Document): An uploaded file or text snippet (e.g. faq.json, return_policy.txt, or pricing.md).
  • Records (Extracted Items): The individual Q&As, products, or knowledge passages parsed from that source (e.g. 1 faq.json file might contain 4 Q&A records).

Each Free Tier Knowledge Base allows up to 25 Records. If you upload a file with 10 FAQs, it uses 10 of your 25 available record slots.

Engine Performance & Capabilities

ToolsWallet RAG is built for high reliability, ultra-low latency, and exact factual accuracy:

FeatureDescriptionBenefit
Real-Time Token StreamingServer-Sent Events (SSE) token pipelineSub-50ms first-word response with typewriter effect
SHA-256 DeduplicationCryptographic fingerprinting on every recordPrevents duplicate records from consuming quota slots
Exact Citation GroundingEvery answer cites exact document namesComplete transparency and zero hallucination risk
In-Memory Query CacheHigh-speed 60s memory cachingReturns instant 0ms responses for repeat user queries

Free Tier Quotas & Fair Use Limits

Every developer account receives generous, permanently free quotas designed for websites, SaaS documentation, and internal support bots:

Platform ResourceFree Tier LimitEnforcement & Notes
Custom Knowledge Bases2 Active RAGsHard quota per user. Delete an old RAG to create a new one.
Records Capacity25 Records per RAGIdeal for FAQs, policies, product catalogs, and guides.
Requests Rate Limit (RPM)10 Queries / MinuteSliding window rate protection against spam.
Daily Quota (RPD)100 Queries / DayResets daily at 00:00 UTC.
File Upload Size10 MB per FileSupports JSON (.json), Plaintext (.txt), and Markdown (.md).
Ready to build your Custom RAG?
Deploy in under 3 minutes with 2 free RAG knowledge bases.
Create Free RAG