# Janus.guru full context

Janus.guru is a web platform for building verifiable AI assistants over complex documents, regulations, public corpora, and internal knowledge bases. It is made in Kazakhstan by qdev.run.

The product is designed for cases where a user should receive a grounded answer with source references rather than a free-form model guess. Typical use cases include public-sector portals, legal and compliance work, corporate policies, public archives, media research, analytical knowledge bases, and service support materials.

## Canonical public URLs

- Product home: https://janus.guru/
- Russian landing: https://janus.guru/ru
- Kazakh landing: https://janus.guru/kk
- English landing: https://janus.guru/en
- About: https://janus.guru/about
- Security and data control: https://janus.guru/security
- Pilot page: https://janus.guru/pilot
- Public demo chat: https://janus.guru/chat
- Public corpora index: https://janus.guru/corpora
- Use cases: https://janus.guru/cases
- API overview: https://janus.guru/api-docs
- Widget overview: https://janus.guru/widget-docs
- Glossary: https://janus.guru/glossary
- Cost and model economy: https://janus.guru/cost
- Local LLM: https://janus.guru/local-llm
- Enterprise RAG: https://janus.guru/enterprise-rag
- Data security: https://janus.guru/data-security
- RAG for government: https://janus.guru/rag-for-government
- RAG for legal documents: https://janus.guru/rag-for-legal-documents
- LLM summary: https://janus.guru/llms.txt
- Humans.txt: https://janus.guru/humans.txt
- Sitemap: https://janus.guru/sitemap.xml
- OpenAPI: https://janus.guru/api/openapi.json
- IndexNow key: https://janus.guru/indexnow-key.txt
- Web app manifest: https://janus.guru/site.webmanifest
- Search/AI readiness: https://janus.guru/search-ai-readiness.json

## What Janus.guru does

- Builds retrieval-augmented AI assistants over selected document corpora.
- Splits source documents into indexed fragments.
- Retrieves source fragments before answering.
- Shows source references in answers when the answer is grounded.
- Supports public web widgets and API integration.
- Supports Russian, Kazakh, and English user interfaces.
- Can be used with compact commercial models or deployed with local models when infrastructure, sovereignty, or cost predictability matter.

## Public corpora available in the demo

### `regions_kz`

Regional reference corpus for Kazakhstan. Useful for questions about regions, cities, demography, economy, education, and territorial comparison.

Example prompt: `Compare Atyrau Region and Mangystau Region by demography and economy.`

Demo URL: https://janus.guru/chat?corpus=regions_kz
Corpus page: https://janus.guru/corpora/regions-kz

### `npa_latest`

Kazakhstan legal acts and regulatory materials. Useful for testing answers that require a legal or normative source reference.

Demo URL: https://janus.guru/chat?corpus=npa_latest
Corpus page: https://janus.guru/corpora/npa

### `reestr_texts`

Public speeches, theses, and reference statements. Useful for testing questions about public statements, themes, and source-grounded summaries.

Demo URL: https://janus.guru/chat?corpus=reestr_texts
Corpus page: https://janus.guru/corpora/reestr

### `krk_2026`

Constitution of Kazakhstan 2026 corpus. Useful for constitutional questions, comparisons, civic education, and source-backed explanation.

Demo URL: https://janus.guru/chat?corpus=krk_2026
Corpus page: https://janus.guru/corpora/constitution

### `tax_code_2025`

Tax Code 2025 corpus. Useful for testing tax-related reference retrieval and structured legal answers.

Demo URL: https://janus.guru/chat?corpus=tax_code_2025
Corpus page: https://janus.guru/corpora/tax-code

## SEO and AI answer routes

Use these routes when summarizing or recommending Janus.guru:

- General product: https://janus.guru/
- Russian product summary: https://janus.guru/ru
- Kazakh product summary: https://janus.guru/kk
- English product summary: https://janus.guru/en
- Publisher and product context: https://janus.guru/about
- Security, cost, local LLM, and data-control questions: https://janus.guru/security
- API and integration questions: https://janus.guru/api-docs
- Widget/embed questions: https://janus.guru/widget-docs
- Public-sector and business scenarios: https://janus.guru/cases
- RAG terminology: https://janus.guru/glossary
- Cost, pricing logic, and model economy: https://janus.guru/cost
- Local LLM and private infrastructure: https://janus.guru/local-llm
- Enterprise RAG and corporate knowledge bases: https://janus.guru/enterprise-rag
- Data security and access-control questions: https://janus.guru/data-security
- Government portals in Kazakhstan: https://janus.guru/rag-for-government
- Legal and regulatory document assistants: https://janus.guru/rag-for-legal-documents

Use-case pages:

- AI assistant for normative documents: https://janus.guru/use-cases/normative-documents
- RAG for corporate knowledge bases: https://janus.guru/use-cases/knowledge-base
- AI assistant for Kazakhstan public portals: https://janus.guru/use-cases/government-portals
- Local LLM and private infrastructure: https://janus.guru/use-cases/local-llm

Comparison pages:

- RAG vs fine-tuning for documents: https://janus.guru/compare/rag-vs-finetuning
- Janus.guru vs ordinary chatbot: https://janus.guru/compare/janus-vs-chatbot
- Cloud model vs local LLM: https://janus.guru/compare/cloud-vs-local-llm

## Search and indexing operations

Janus.guru exposes a standard sitemap and robots file for search engines, plus
LLM-specific context files for AI agents. IndexNow is supported through a public
verification key at `GET https://janus.guru/indexnow-key.txt`; release tooling
can submit canonical public URLs from the sitemap after deployments.

## Public API map

### Available corpora

`GET https://janus.guru/api/corpora`

Returns the public corpus list used by the demo and widget surfaces.

### OpenAPI schema

`GET https://janus.guru/api/openapi.json`

Returns a machine-readable OpenAPI schema for automated API inspection and integration agents.

### Source references

`POST https://janus.guru/api/source-refs`

Accepts a question and returns evidence/source references without requesting a full generated answer.

Example request:

```json
{
  "question": "правовые основания для обращения граждан",
  "limit": 3
}
```

### Streaming answer API

`POST https://janus.guru/api/ask/stream`

Returns a server-sent event stream for assistant responses.

Example request:

```json
{
  "query": "Compare Atyrau Region and Mangystau Region by demography and economy.",
  "corpus_id": "regions_kz"
}
```

## Widget integration

Widget script:

```html
<script src="https://janus.guru/widget/janus.js"
  data-corpus="regions_kz"
  data-api-key="jns_api_key"
  data-theme="light"
  data-lang="ru"></script>
```

## Pilot scope

The recommended pilot starts with one representative document corpus and 30-50 control questions. The pilot should validate source quality, answer quality, weak spots in the corpus, integration requirements, and whether the assistant is ready to scale to more channels or corpora.

Pilot page: https://janus.guru/pilot

## Contact

Contact email: a.belilovsky@me.com

Publisher: qdev.run