Skip to content

Welcome to the YaoXiang Universe!

"From non-polarity comes the Supreme Ultimate. The Supreme Ultimate moves and produces yang, stillness produces yin." — Zhou Dunyi, "Explanation of the Diagram of the Supreme Ultimate"

This is the center of the YaoXiang universe.

In Eastern philosophy, "Yao" (hexagram lines) are the basic symbols that form hexagrams, containing all the transformations of yin and yang. "Xiang" (images) are the external manifestations of the essence of things, and all phenomena follow discernible patterns.

YaoXiang is an attempt to integrate this ancient wisdom into a modern type system.

What is YaoXiang?

Imagine you're building with LEGO blocks:

ConceptLEGOYaoXiang
Basic unitBuilding blocksType
How to combineSnapping togetherFunction mapping
Final productPlanes, carsPrograms

In the YaoXiang world, everything is a type:

  • Numbers are types, text is types
  • Types themselves are also types (meta types)
  • Functions are bridges from type to type

Core Features

FeatureYaoXiangExample in Other Languages
Type systemDependent types + parametric polymorphismTypeScript
Memory managementOwnership model (no GC)Rust
Async programmingSpawn model (seamless concurrency)async/await
Syntax stylePython stylePython

One-liner summary: As smooth as writing Python, as safe as Rust.

Learning Path

Users with Programming Experience

If you have programming experience, we recommend starting with "Getting Started for Experienced Programmers".

🚀 Getting Started for Experienced Programmers →

Users without Programming Experience

If you're new to programming, we recommend starting with "Getting Started from Zero".

💡 Getting Started from Zero →

💡 Tip: Not having programming experience is actually an advantage — without the baggage of other languages, you can most directly understand the design philosophy of YaoXiang.

Who is YaoXiang for?

  • ✅ Explorers who want to understand programming language design
  • ✅ Enthusiasts who enjoy functional programming
  • ✅ Practitioners interested in type systems
  • ✅ Developers who want to experience "seamless concurrency"
  • ❌ Teams that need to immediately put it into production projects (language is still in experimental stage)

"The Tao that can be told is not the eternal Tao." — YaoXiang is still in an early exploration stage, and every pioneer is shaping its future.

What's Next

🚀 Quick Start →

Or start with core concepts:

We recommend starting with Quick Start for a systematic learning.


"The heavens move with strength, and the gentleman strives for unremitting self-improvement."

May you discover your own Tao in the YaoXiang universe.