aora-bot
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 618 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Emotion Ball 是一套面向 AI 助手的表情引擎:32 种状态表情全部由纯 SVG 与原生 JavaScript 实时驱动,零框架、零图片资源。AI 侧只需输出一个 emotionId,小球即可切换到对应表情,可直接用作聊天机器人、桌面宠物、悬浮助手的情绪表达层。
Aora Bot
A procedural character engine for the web — a roster of generated characters, animated states, three faces, three drawing styles, an SVG HUD, and the UI surfaces built on top of them.
Console | Documentation | Scenarios | 中文
What this is
A cartoon character that is drawn entirely by code. There are no sprite sheets and no
Lottie files — every body is an outline in code (some with ears, leaves or an antenna as
separate parts), every expression is a few numbers describing a curved stroke,
interpolated by springs, and every animation frame is written directly to SVG attributes
by a requestAnimationFrame loop.
The roster has 46 characters, from round blobs and rice cakes to fruit, critters and people.
Here they all are, happy, in the default cute face:
Every character combines independent choices, all of which you can try in the
console: the character itself, the style (vector, pixel
or kaomoji) and its variant, the ink colour, the face and the animation state.
One cat in every style: vector (solid, outline, glass, sticker, paper, soft, riso), pixel (crisp, dot, block) and kaomoji (plain, bubble).
On top of the engine sits a set of React components for the things products actually need
from a character system: a stable character per user derived from any id, shape and
colour pickers, an avatar editor with image crop, group avatar stacks, chat activity
indicators, a numeric emotion protocol for AI agents, a HUD that draws progress, timers,
waveforms and KPIs in the ring around the character, and a stage that lets hundreds of
characters share a handful of animations. Onboarding and restricted-state scenes, template
publishing, occupancy lists and cast stages are a separate package built on those.
The default face is cute (dot eyes, a small mouth, a blush). The eyes face and the
line face — a parametric nose and mouth drawn in the same ink and stroke weight as the
eyes — are available with face="eyes" and face="line".
Quick start
pnpm add @aora-bot/react
import { CharacterMark } from '@aora-bot/react';
import '@aora-bot/react/styles.css';
<CharacterMark shape="mochi" state="happy" sizePx={96} />;
Requires React 19. The product surfaces (walkthrough, scenes, template dialog,
occupancy list, cast stage) are optional:
pnpm add @aora-bot/surfaces @aora-bot/react
import { RestrictedScene } from '@aora-bot/surfaces';
import '@aora-bot/react/styles.css';
import '@aora-bot/surfaces/styles.css'; // after the react stylesheet
Packages
| Package | What it does |
|---|---|
@aora-bot/engine |
The engine. Shapes and style series, face fitting, pose projection, spring integrator, state machine, belts, HUD dials, particles, emotion protocol and arbiter. No React; /static and /agent need no DOM. |
@aora-bot/react |
React components. CharacterMark, MarkStageProvider, avatars and stacks, pickers, avatar editor, activity marks, HUD plates, agent state, sprites, confetti, locale provider. |
@aora-bot/surfaces |
Product and demo surfaces built on @aora-bot/react. Walkthrough pieces, scenes, template dialog and publishing, occupancy list, cast stage. Peer-depends on the engine and the React package. |
Each package has its own README: packages/engine,packages/react,packages/surfaces.
Repository layout
packages/engine/ from-scratch character engine (TypeScript)
packages/react/ React component layer
packages/surfaces/ product and demo surfaces on top of the React layer
docs/ Rspress documentation site
examples/ standalone samples, not part of the workspace build
From Emotion Ball to Aora Bot
This repository used to hold Emotion Ball. Emotion Ball has now been upgraded to Aora Bot; the old code is no longer maintained and no longer kept here.
- A rewritten engine: a handful of plain JavaScript scripts became three npm packages written in TypeScript, with full types, tests and server rendering.
- Original characters: the old ball-shaped characters are retired. All 46 characters are newly designed originals, and Nimbo and Twinkle from Mood Mates have joined the cast as originals too.
- More to work with: 32 expressions grew into 44 animation states, with three faces, three styles (vector, pixel and kaomoji), HUD dials and a full set of React components. The emotion protocol still accepts
{ emotionId }messages, so the AI side connects the same way. - License: from free for personal study with separate commercial licensing, to MIT, ready for commercial projects.
Contributing
See CONTRIBUTING.md.
Sponsor
If Aora Bot gave your interface a little more expression, you are welcome to buy the author a coffee.
WeChat Pay |
Alipay |
More about it on the sponsor page.
Contact
Add me on WeChat: questions, collaboration or suggestions |
Join the QQ group: 626080597 |
Become a sponsor
Aora Bot is built for front-end, AI and hardware developers, and designers use it for avatars and mascots. A sponsor's logo goes here and on the sponsor page.
| Lead sponsor Open seat |
|
| Sponsor Open seat |
Sponsor Open seat |
Who reads it: React and front-end developers, AI agent builders, hardware makers, designers and indie developers. Ideal sponsors:
- AI models and agent platforms: the core audience builds interfaces for AI assistants and agents; the emotion protocol and the Claude Code and Cursor adapters are made for them.
- Dev boards and smart hardware: makers putting a face on small screens and desk devices, right when they choose a board for a smart toy or desk companion.
- Cloud and hosting platforms: readers are mostly React and front-end developers, and every one of them ships somewhere.
- Developer tools and IDEs: the audience writes code every day, and the people who see the logo decide what their team uses.
- Coding education and courses: one line of code brings a character to life, which also draws developers just learning front end and AI.
- Design tools and asset platforms: designers and indie developers come here for avatars, mascots and expressions.
Add me on WeChat above and mention sponsorship.
License
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi