# QSign Translator

> Open RU/KZ/EN sign-language planning prototype by qdev.run. QSign converts short text or transcribed audio into a transparent sign-plan draft, shows dictionary coverage and fingerspelling fallbacks, supports human review, and exports structured briefs for external AI video generators.

Canonical site: [https://qsign.qdev.run/](https://qsign.qdev.run/)
Public repository: [https://github.com/belilovsky/qsign-translator](https://github.com/belilovsky/qsign-translator)
OpenAPI schema: [https://qsign.qdev.run/openapi.json](https://qsign.qdev.run/openapi.json)
Sitemap: [https://qsign.qdev.run/sitemap.xml](https://qsign.qdev.run/sitemap.xml)

## Best public pages

- [About QSign](https://qsign.qdev.run/about) - project purpose, users, and scope.
- [How QSign works](https://qsign.qdev.run/how-it-works) - text-to-sign pipeline.
- [Methodology](https://qsign.qdev.run/methodology) - transparent sign-plan method and human-review gates.
- [Examples](https://qsign.qdev.run/examples) - sample phrases, coverage, fallback, and review notes.
- [Russian / RSL route](https://qsign.qdev.run/languages/ru-rsl) - Russian-language route.
- [Kazakh / KRSL route](https://qsign.qdev.run/languages/kk-krsl) - Kazakh-language route.
- [English / ASL route](https://qsign.qdev.run/languages/en-asl) - English-language route.
- [Sources](https://qsign.qdev.run/sources) - source registry and license notes.
- [Safety](https://qsign.qdev.run/safety) - human-review rules and high-risk domains.
- [API](https://qsign.qdev.run/api) - public API entry points.
- [Developers](https://qsign.qdev.run/developers) - API examples and integration rules.
- [Open source](https://qsign.qdev.run/open-source) - repository, contribution, and disclosure links.
- [Roadmap](https://qsign.qdev.run/roadmap) - product development direction and limitations.
- [FAQ](https://qsign.qdev.run/faq) - concise answers for users and AI systems.
- [Glossary](https://qsign.qdev.run/glossary) - sign-plan terminology.
- [AI context](https://qsign.qdev.run/ai-context.md) - compact machine-readable guidance.
- [AI use guidance](https://qsign.qdev.run/ai-use.md) - safe claims, unsafe claims, and citation guidance.
- [Public JSON context](https://qsign.qdev.run/public-context.json) - structured public facts.
- [Claims JSON](https://qsign.qdev.run/claims.json) - structured claims with evidence links.
- [Humans](https://qsign.qdev.run/humans.txt) - team, purpose, and public machine context.
- [Security](https://qsign.qdev.run/.well-known/security.txt) - disclosure contact and policy.

## What this service is

- A research and operator tool for preparing sign-language draft plans.
- Languages: Russian (RU/RSL-oriented), Kazakh (KK/KRSL-oriented), and English (EN/ASL-oriented seed layer).
- Outputs: sign-plan units, coverage trace, review state, render contract, and AI-video handoff packages.
- Safety stance: QSign is not a certified interpreter and does not claim autonomous fluent sign-language translation.

## Best pages and endpoints for AI agents

- [`GET /`](https://qsign.qdev.run/) - browser UI and product explanation.
- [`GET /openapi.json`](https://qsign.qdev.run/openapi.json) - machine-readable API schema.
- [`GET /methodology`](https://qsign.qdev.run/methodology) - project method and review policy.
- [`GET /examples`](https://qsign.qdev.run/examples) - citation-friendly examples.
- [`GET /developers`](https://qsign.qdev.run/developers) - API usage guidance.
- [`GET /ai-context.md`](https://qsign.qdev.run/ai-context.md) - concise AI context file.
- [`GET /ai-use.md`](https://qsign.qdev.run/ai-use.md) - safe AI summary and citation rules.
- [`GET /public-context.json`](https://qsign.qdev.run/public-context.json) - structured public project metadata.
- [`GET /claims.json`](https://qsign.qdev.run/claims.json) - structured public claims with evidence.
- [`GET /humans.txt`](https://qsign.qdev.run/humans.txt) - public project and publisher notes.
- [`GET /.well-known/security.txt`](https://qsign.qdev.run/.well-known/security.txt) - security contact and disclosure policy.
- `POST /v1/translate/text` - creates a draft sign-plan from text.
- [`GET /v1/sources`](https://qsign.qdev.run/v1/sources) - lists source registry entries and license/access notes.
- [`GET /v1/lexicon?language=ru`](https://qsign.qdev.run/v1/lexicon?language=ru) - returns exposed lexicon entries.
- `GET /v1/jobs/{job_id}/render-plan` - returns a structured render-plan manifest for a saved job.
- `GET /v1/jobs/{job_id}/ai-video-brief` - returns export packages for external video workflows.

## Use constraints

- Prefer short, concrete phrases.
- Treat fallback/fingerspelled units as unresolved and requiring human review.
- Do not present the output as a certified sign-language translation.
- High-risk medical, legal, emergency, finance, and public-safety content requires a human interpreter.
- Do not expose review tokens, session cookies, private job data, or deployment secrets.

## Recommended citation

QSign Translator, qdev.run, [https://qsign.qdev.run/](https://qsign.qdev.run/)