FAQ
Cross-track common questions. Sorted by audience role — find your role and jump. For capability-specific issues, see Common pitfalls.
Overview
| You are | Jump to |
|---|---|
| Writer / teacher / blogger | §1 Writers |
| AI app / prompt engineer | §2 AI engineers |
| Integration developer (adding Rho rendering to your project) | §3 Integrators |
| Business procurement / legal | §4 Business / legal |
| Protocol implementer (writing your own reader) | §5 Protocol implementers |
| Academic researcher | §6 Academic |
1. Writers
Q: I'm a blogger / teacher / student — where do I start?
→ What is Rho? — 5-min philosophy → 5-minute tour — see all 15 capabilities → Your first interactive .md — build a compound interest calculator → Cheatsheet — printable one-page reference
Q: Where can I render my Rho documents?
In Rho MD — the free app for Windows, macOS, Linux, Android, iPhone and iPad (download). There is no browser editor; rendering happens in the app. Documents published with Rho MD can also be read in the browser on Rho Library. The renderer is not published as a library yet.
See Install Rho app.
Q: Can my .md file be viewed on GitHub?
✅ Yes — Rho protocol guarantees plain-text fallback. GitHub web rendering: standard markdown parts render normally + Rho blocks display as code-block literals. Readers can still understand the content fully.
Q: I don't want to install anything — can I use it directly?
To write, yes — any text editor works, and the file reads as ordinary Markdown anywhere (GitHub, a gist, your notes app). To see it run, you need the Rho MD app; there is no browser version for your own files (documents published with Rho MD can be read on Rho Library).
Q: My personal blog uses Rho — free?
✅ Fully free. See Free use FAQ.
Q: I run paid online courses — can I use Rho?
✅ Yes. Rho MD is free for personal use and for your work under the Terms of Service, and the format (AINP) is CC BY 4.0. See Free use FAQ.
Q: How do I avoid common mistakes?
→ Common pitfalls — cross-capability overview
Q: I want to see more demos for ideas
→ Examples gallery — 20+ complete copy-paste demos
2. AI engineers
Q: I'm building an AI app — how do I get LLMs to generate Rho?
→ AI/LLM Guide overview — 3 integration modes → Prompt templates — 7 ready-to-use prompts → Schema-aware generation — high-accuracy function calling → Common LLM mistakes & repair — 10 LLM errors + auto-repair
Q: Which mode is most reliable?
For production, recommended: function calling + 5-10 few-shot examples + server-side validation.
Q: Can LLM output render directly to end users? Is it safe?
✅ Safe. Rho protocol-layer forbids arbitrary JS / network / eval / side effects. LLM errors at worst fall back to code-block literals — can't inject malicious code. See AINP §17.
Q: Should I use ChatGPT / Claude / Gemini?
The major LLMs all support function calling / JSON mode. The choice of model matters less than engineering practices (prompt design + few-shot selection + validation pipeline). Choose whichever you have API integration with.
Q: I want to fine-tune my own model — is there training data?
No ready-made fine-tuning dataset (community contributions welcome). Suggestions:
- Collect high-quality samples from your production schema-driven generation
- At least 500-1000 examples to start fine-tuning
- All major LLM platforms support (OpenAI / Anthropic / Together)
3. Integrators
Q: I have my own web project and want to add Rho rendering — how do I start?
The renderer behind Rho MD is not published as a library yet, so there is nothing to install. The format is open (CC BY 4.0), so you can render it yourself:
→ Developer Reference — where things stand → AINP protocol — syntax and behaviour of every block → Implementing your own reader — implementation walkthrough
Q: I'm writing a plugin for Obsidian / VS Code / Bear — how do I integrate?
Implement the format from the spec. AINP is CC BY 4.0, so your plugin's licence is yours to choose → see Implementing your own reader.
4. Business / legal
Q: My company wants to integrate Rho into our product — do we need to pay?
Using Rho MD at work is free. To show Rho documents inside your own product, implement the format (CC BY 4.0); the app itself cannot be bundled or redistributed (Terms of Service §2). Rho Cloud plans are optional. See Free use FAQ.
Q: How do I get a quote?
There is nothing to quote: Rho MD is free, and the Rho Cloud plans (Rho Pro, Rho Pro Plus, Rho Max) are listed at rho.md/#pricing and bought in the app under Settings › Account. Other questions: 📧 [email protected].
Q: What's the license scope?
- Spec (AINP): CC BY 4.0 — anyone, any purpose, free
- Rho MD app: free for personal use and for your work under the Terms of Service (no redistribution or bundling)
- Rho Cloud: free account; paid plans Rho Pro / Rho Pro Plus / Rho Max — see pricing
See License overview.
Q: We have compliance requirements (GDPR / SOC 2 / ISO 27001) — supported?
→ Rho MD keeps your documents as files on your own device → What Rho Cloud stores is set out in the Privacy Policy → Rho holds no SOC 2 or ISO 27001 certification, and Rho Cloud is not offered for HIPAA- or PCI-regulated data
Q: Can a startup afford it?
✅ Rho MD is free for personal use and for your work; Rho Cloud plans start at $5/month. See pricing.
5. Protocol implementers
Q: I want to build a new reader implementation — where do I start?
→ AINP protocol document (v0.9) — authoritative protocol definition → Implementing your own reader — implementation walkthrough
Q: What's the protocol license?
AINP is CC BY 4.0 — you can implement freely; your implementation's license is yours to choose (MIT / Apache / commercial / closed). We ask for a credit line in your docs ("Implements Rho format spec by scos-lab").
Q: How much work is implementation roughly?
About 13 person-days for Full conformance. See Implementing your own reader §Recommended steps.
Q: How do I declare my reader "implements AINP"?
Per AINP §19, declare which level: Full / Static-only / Reader (no animation) / Partial.
Q: Trademark / naming rules?
✅ "MyReader (implements AINP v0.9)" ✅ "FooMD with AINP support" ❌ "AINP Reader" (protocol name ≠ implementation name) ❌ "Rho Clone" (Rho is the reference impl name)
See Implementing your own reader §Naming.
Q: Can I add capabilities outside the protocol?
✅ Yes ("non-standard extension"), but MUST:
- Use distinct lang label / directive name (avoid conflicts)
- Clearly mark in docs as "non-standard"
- Remain readable in fallback readers
See AINP protocol.
6. Academic
Q: How do I cite AINP in a paper?
@misc{ainp2026,
title = {AI-Native Interaction Protocol (AINP), version 0.9},
author = {scos-lab},
year = {2026},
publisher = {scos-lab},
url = {https://rho.md/docs/en/developer/ainp-protocol.html},
note = {CC BY 4.0.}
}
Q: Is Rho free for academic research?
✅ Yes — Rho MD is free for personal use and for your work under the Terms of Service, and AINP is CC BY 4.0. See Free use FAQ.
Q: Does the protocol have a reference implementation test suite?
⏸️ Conformance test pack planned for v1.0 stable release (not v1 working draft). For now, Examples gallery serves as informal reference.
Q: Are there academic papers comparing with markdown / MDX / MyST?
⏸️ No official paper yet. Community papers / blog posts welcome — can use Comparison as a starting point. If published, PRs to References section welcome.
General questions
Q: What's the relationship between AINP and Rho?
- AINP = open protocol (CC BY 4.0)
- Rho = scos-lab's reference implementation: the Rho MD app, with the Rho Cloud account service and Rho Library (lib.rho.md) for published documents
- Anyone can build their own AINP-conformant reader (need not be called Rho)
See Glossary §AINP + Glossary §Rho.
Q: Where can I find an index of all docs?
- Writer's Guide — for writers
- Developer Reference — for developers
- AI/LLM Guide — for AI integration
- License — for legal / business
- Resources — Changelog / Roadmap / Community
- Glossary — terminology
- Cheatsheet — one-page syntax reference
- Comparison — vs MDX / MyST / Quarto / etc.
Q: My question isn't here — where do I ask?
By question type:
- Usage questions → rho.md/feedback
- Bug reports → rho.md/feedback
- Business / legal → 📧
[email protected] - Security vulnerability → 📧
[email protected]subject[SECURITY]
See Community.
Q: Can I contribute docs / code?
Rho MD's source code isn't public, so we can't take code contributions. Docs fixes and examples are welcome through rho.md/feedback. See Community §Contributing docs.
See also
- Glossary — Terminology
- Comparison — vs other tools
- Cheatsheet — One-page syntax
- Common pitfalls — Common writer errors
- Roadmap — Protocol future direction