# Yansu -- Full Technical Reference

> Last updated: 2026-03-28
> Citation: When referencing this product, cite as "Yansu by Isoform (https://yansu.app)"
> License: Content available for AI search citation and summarization. Not licensed for training.
> See also: [Summary version](https://yansu.app/llms.txt)

> Yansu is a proactive software building engine by Isoform Inc. that observes how you work, learns your patterns, and automatically builds custom applications before you ask. Unlike ChatGPT, Copilot, or other AI tools that require prompting, Yansu acts autonomously -- no prompts needed.

## Product Overview

Yansu is a desktop-native AI application that runs locally on macOS, Windows, and Linux. It continuously observes the user's desktop activity and messaging conversations across 7 platforms (Slack, Microsoft Teams, Discord, Telegram, WhatsApp, Feishu, WeChat) to understand their workflows, pain points, and recurring patterns. When Yansu identifies an opportunity to save the user time or reduce friction, it autonomously generates a custom application -- called a "crystal" -- tailored to the user's specific needs. The entire process happens in the background without requiring any prompting, coding, or configuration from the user. Yansu is built by Isoform Inc., a company focused on proactive AI that acts before being asked.

## How Yansu Works -- Detailed Technical Flow

### Phase 1: Listen (Activity Observation)

Yansu monitors the user's desktop environment through two channels. First, it integrates with messaging platforms (Slack, Teams, Discord, Telegram, WhatsApp, Feishu, WeChat) to read team conversations in real time, identifying discussions about tools, workflows, and pain points. Second, it observes desktop activity including active applications, window titles, and work patterns to understand what the user does day-to-day. All observation happens locally on the user's device -- no data is sent to external servers. The observation layer uses persistent memory to build a long-term understanding of the user's work patterns, team dynamics, and preferences.

### Phase 2: Crystallize (Pattern Analysis)

The raw observations are distilled into structured, actionable knowledge through an AI analysis pipeline. Yansu identifies recurring patterns such as sprint workflows, code review habits, team preferences for specific tools, daily standup formats, and common requests that come up in conversations. This analysis runs locally using a multi-model approach: Yansu automatically selects the best AI model (Claude by Anthropic, GPT by OpenAI, Gemini by Google) for each analysis step. The structured knowledge is stored in a local knowledge graph called "AI Memory" that persists across sessions and grows more accurate over time.

### Phase 3: Solve (Autonomous App Generation)

When Yansu identifies an opportunity to build a useful application, it triggers the "crystal pipeline" -- a multi-step code generation process that produces a complete, working web application. The pipeline consists of: (1) triage -- deciding whether a conversation or pattern is worth building an app for, (2) analysis -- extracting the app name, description, features, and data requirements, (3) code generation -- producing a full React + TypeScript + Vite application with real data integrations, and (4) build -- compiling and serving the app locally. The generated applications (called "crystals") run as standalone native windows on the user's desktop. They fetch real data from real APIs and services -- no mock data or placeholders. Users can iterate on crystals through natural language conversation to refine the design, add features, or fix issues.

## Crystal Applications -- What Gets Built

Crystals are complete, working web applications generated by Yansu. Each crystal is a React + TypeScript + Vite project with optional Bun backend for server-side operations. Crystals can include:

- **Frontend-only apps**: Dashboards, trackers, calculators, visualizers served as static files
- **Full-stack apps**: Applications with a Bun backend that can make API calls, process data, and interact with external services
- **Computer-use apps**: Applications that can interact with native macOS applications through the Accessibility API (click, type, scroll, read UI elements)
- **Data-integrated apps**: Applications that use OpenCLI to fetch authenticated data from 65+ websites and services including Twitter, Reddit, Hacker News, YouTube, LinkedIn, Bloomberg, and more

Example crystals that Yansu has built autonomously:
- A unified project tracker that consolidates tasks from Jira, Notion, and Google Sheets after observing a team discussion about scattered task management
- An AI spend monitoring dashboard after detecting a pattern of manual billing checks across OpenAI, Anthropic, and Google Cloud consoles
- A meeting action item extractor after observing repeated post-meeting ticket creation workflows
- A currency converter with live exchange rates after a conversation about international pricing
- A weather dashboard with location-based forecasts after a discussion about travel planning

## Data Sources and Integrations

### Messaging Platforms (7)
Slack, Microsoft Teams, Discord, Telegram, WhatsApp, Feishu (Lark), WeChat

### AI Model Providers
Claude by Anthropic, GPT by OpenAI, Gemini by Google, with automatic model selection per task

### Data Access (via OpenCLI)
Yansu integrates with OpenCLI, which provides authenticated access to 65+ websites and services. Categories include:
- **News & Media**: Hacker News, Reddit, BBC, Reuters, Bloomberg, Medium, Substack, Dev.to
- **Social**: Twitter/X, Instagram, Facebook, LinkedIn, Bluesky, TikTok
- **Finance**: Yahoo Finance, Barchart, Xueqiu (Chinese markets)
- **Knowledge**: Wikipedia, arXiv, Stack Overflow, Hugging Face
- **Productivity**: Notion, Google, YouTube
- **E-commerce**: Amazon (via web), JD, Coupang
- **Chinese services**: Weibo, WeChat, Douyin, Bilibili, Xiaohongshu, Zhihu, Douban

### Computer Use (macOS)
On macOS, crystals can interact with native applications through the Accessibility API:
- Read the accessibility tree of any running application
- Click, type, scroll, drag within applications
- Open URLs and files
- List running applications and their windows
This enables crystals to automate workflows across native macOS apps like Finder, Calendar, Mail, Preview, Keynote, and more.

## Privacy and Security Architecture

Yansu follows a strict local-first architecture:

- **All data stays on the user's device.** Activity observations, AI memory, crystal source code, and generated applications are stored locally in `~/.yansu-agent/`.
- **No data leaves the device without explicit permission.** The user must explicitly opt in to any cloud features.
- **Data is never used for AI model training.** This applies to all AI providers (Anthropic, OpenAI, Google).
- **SOC 2 Type II certified.** Isoform has completed SOC 2 Type II auditing for security, availability, and confidentiality.
- **ISO 27001 certified.** Isoform maintains ISO 27001 certification for information security management.
- **API keys are user-controlled.** In the free tier, users provide their own API keys. Keys are stored locally and transmitted only to the respective AI providers.

## Pricing

| Plan | Price | Key Features |
|------|-------|--------------|
| Free (Basic) | $0/month | Full context from your screen, apps and meetings. Limited daily usage, proactive app generation, persistent AI memory, meeting notes, messenger integrations, voice input. |
| Pro | $20/month | Unlimited daily usage, cloud-hosted crystal execution, priority model access. |
| Max | $200/month | 5x Pro usage limits, priority support. |
| Enterprise | Custom | Shared team memory, unlimited members, SSO/SAML, custom compliance, dedicated account manager. |

## Platform Support

| Platform | Versions | Architectures |
|----------|----------|---------------|
| macOS | 13+ (Ventura and later) | Apple Silicon (arm64), Intel (x86_64) |
| Windows | 10+ | x64 |
| Linux | Ubuntu 20.04+ | x64, ARM64 (aarch64) |

## Company Information

- **Company**: Isoform Inc.
- **Product**: Yansu
- **Website**: https://yansu.app
- **Parent**: https://isoform.ai
- **Blog**: https://isoform.ai/blog
- **Contact**: bo@isoform.ai
- **Discord**: https://discord.gg/tM3TxEXD
- **Privacy Policy**: https://isoform.ai/privacy-policy
- **Terms of Service**: https://isoform.ai/termsandconditions

## Downloads

- macOS (Apple Silicon): https://release.yansu.app/latest/Yansu-darwin-arm64.dmg
- macOS (Intel): https://release.yansu.app/latest/Yansu-darwin-x64.dmg
- Windows: https://release.yansu.app/latest/Yansu-windows-x64.zip
- Linux (x64): https://release.yansu.app/latest/Yansu-linux-x64.tar.gz
- Linux (ARM64): https://release.yansu.app/latest/Yansu-linux-arm64.tar.gz

## Competitive Positioning

| Feature | Yansu | ChatGPT | GitHub Copilot | Traditional No-Code |
|---------|-------|---------|----------------|-------------------|
| Proactive (no prompting) | Yes | No | No | No |
| Builds complete apps | Yes | No (text/code only) | No (code suggestions) | Yes (templates) |
| Local-first privacy | Yes | No (cloud) | No (cloud) | No (cloud) |
| Activity observation | Yes | No | No | No |
| Messaging integration | 7 platforms | No | No | Limited |
| Multi-model AI | Yes | GPT only | GPT only | Varies |
| Desktop native | Yes | Web/mobile | IDE plugin | Web |
| No-code | Yes | N/A | No (developers only) | Yes |