aora-bot

agent
Guvenlik Denetimi
Gecti
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.

SUMMARY

Emotion Ball 是一套面向 AI 助手的表情引擎:32 种状态表情全部由纯 SVG 与原生 JavaScript 实时驱动,零框架、零图片资源。AI 侧只需输出一个 emotionId,小球即可切换到对应表情,可直接用作聊天机器人、桌面宠物、悬浮助手的情绪表达层。

README.md

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 | 中文

Six Aora Bot characters, a mochi, a strawberry, a cat, a star, a robot and an octopus, moving through happy, excited, shy, surprised, curious, thinking, asleep, angry and celebrating


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:

The whole roster of 46 characters in a grid, each smiling, with its shape id underneath

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 drawn in every style: the seven vector variants, the three pixel variants and both kaomoji variants, all moving together
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 QR code
WeChat Pay
Alipay QR code
Alipay

More about it on the sponsor page.

Contact

Personal WeChat QR code
Add me on WeChat: questions, collaboration or suggestions
QQ group QR code
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

MIT

Yorumlar (0)

Sonuc bulunamadi