← all repositories
SocialAI-tianji/Tianji

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.

Tianji
Velocity · 7d
+28
★ / day
Trend
↗accelerating
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.