An LLM that knows when to toast, when to flatter, and when to write your grandpa a fu
Tianji is a Chinese open-source project teaching LLMs the delicate art of social etiquette — toasts, gifts, blessings, and awkward silences — while doubling as a full-stack LLM tutorial.

What it does
Tianji (天机, roughly “heaven’s secrets”) builds LLM applications around traditional Chinese social situations: toasting etiquette, gift-giving, defusing awkward moments, and composing blessings in styles ranging from casual chat to full classical Chinese prose. The same problem is solved four ways — prompt engineering, RAG knowledge bases, agents, and fine-tuned models — which is the point: it’s structured as a learn-by-example LLM development course.
The interesting bit
The “wishes” model (v0.2, in 3B/7B/14B Qwen-based sizes) writes personalized greetings in multiple registers — the sample output includes a Spring Festival message to grandpa written as a genuine parallel-prose fu. The real value, though, is the full pipeline being open: corpus, data-cleaning tools, training configs, and reproduction docs are all published on Hugging Face.
Key highlights
- Four implementation paths for the same task: prompt, RAG (LangChain/LlamaIndex), MetaGPT-based agents, and LoRA/full fine-tuning (Transformers, Xtuner)
- Open datasets on Hugging Face covering toasting, wishes, and general social-etiquette corpora
- Supports ChatGPT, Qwen, DeepSeek, ERNIE, InternLM, ZhipuAI — online or local
- Companion tutorial docs aim to take you from zero to entry-level LLM full-stack development
- Actively maintained through late 2024, with a WeChat community and multilingual READMEs (EN/JA)
Caveats
- The Agent module link in the README literally points to “修复中,请等待” (“under repair, please wait”) — that part is a work in progress
- Everything is Chinese-language and China-stack-centric (ModelScope, WeChat); less useful if that’s not your context
Verdict
A charming, unusually complete teaching repo if you read Chinese and want to learn prompt→RAG→agent→fine-tuning on one concrete problem. If you’re hunting for production etiquette tooling, this is a classroom, not a product.
Frequently asked
- What is SocialAI-tianji/Tianji?
- Tianji is a Chinese open-source project teaching LLMs the delicate art of social etiquette — toasts, gifts, blessings, and awkward silences — while doubling as a full-stack LLM tutorial.
- Is Tianji open source?
- Yes — SocialAI-tianji/Tianji is open source, released under the Apache-2.0 license.
- What language is Tianji written in?
- SocialAI-tianji/Tianji is primarily written in Python.
- How popular is Tianji?
- SocialAI-tianji/Tianji has 2k stars on GitHub and is currently accelerating.
- Where can I find Tianji?
- SocialAI-tianji/Tianji is on GitHub at https://github.com/SocialAI-tianji/Tianji.