3d-gen

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 23 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

Free, open-source generator for realistic, rigged and animated 3D characters, in the browser, in code or from your AI assistant.

README.md

Ara 3D Gen

Build it. Film it. Play it.

Create realistic 3D characters, direct them in films, and build games with missions, races and runs to share online. Free, in your browser.

Ara is Yoruba for "body". Open source, MIT-licensed, with no accounts, credits or limits.

▶ Try it online: ara3dgen.com, or self-host it (below).

Ara has three apps that share the same characters:

  • The character builder: shape a body, dress it, give it hair, tattoos and a weapon, pick from 216 animations and export GLB, FBX, OBJ or a ZIP bundle for any engine.
  • Ara 3D Studio: direct up to five characters on 66 sets, with dialogue, sound and music, and export an MP4.
  • Ara Play: build games from missions, arcade races and endless runs, string them into a campaign, and publish it online in about a minute.

Presets: Female Executive, Miami Dealer, Gangster, Priest, Corporate High-Flier, Prison Escapee, Arabian Oil Tycoon, Adventurer

A motion-captured walk, a face with expressions that talks, and riding a bicycle in Ara 3D Gen

Dead Drop, a game made in Ara Play: escaping with a rescued companion, a shootout, driving through the city, runner power-ups, an arcade race, then customizing the game and publishing it online
Made in Ara Play: Dead Drop, a ten-chapter game, played live · preview without audio · Watch with sound · Try Ara Play

The Ara 3D Studio reel: a tank and a helicopter, a jet takeoff, a parachute jump, a shootout, a highway race, a street café, a rooftop chase and a beach scene, ending in the Studio editor
Made in Ara 3D Studio: every shot was made and exported in Studio · preview without audio · Watch with sound · Try Studio

Why self-hosted?

Online character generators are convenient, but you rent them. Ara 3D Gen is yours:

Online platforms Ara 3D Gen
Cost Subscriptions, credits or per-export fees Free, MIT-licensed
Limits Monthly export or generation caps Unlimited, as many characters as your machine can make
Privacy Your projects live on someone's server Nothing leaves your computer
Offline Needs an internet connection Works offline once set up
Automation Usually a web UI only, sometimes a paid API Scriptable CLI and a TypeScript API: generate hundreds of NPCs in a loop
Ownership Licence terms can change or restrict use CC0 base assets and free motion capture: use exports commercially, no attribution
Customisation What the vendor ships Fork it: add garments, hairstyles, animations, presets, export rules
Longevity The service can shut down or change pricing The code and your pipeline stay with you

Features

Characters

  • Realistic humans: built on the CC0 MakeHuman dataset: 900+ morph targets, 219 detail sliders, 20 photo-based skins across age, ethnicity and sex, three detail levels (≈5k to 120k triangles).
  • Quick build: a guided mode where you tap options (body, heritage, 30 outfit styles, colours, hair, extras, vehicles and an action) and watch the character update. Pick a vehicle to preview its matching animation, then choose its colour, style and finish. Plain-words summary, undo, Surprise me, and every unavailable option explains why. Detailed has every slider.
  • 32 presets: including the Female Executive, Miami Dealer, Gangster, Priest, Corporate High-Flier, Prison Escapee, Arabian Oil Tycoon and Adventurer. Plus one-click, reproducible random characters.
  • Clothing: MakeHuman outfits, or mix-and-match tops, bottoms, uniforms and 30+ accessories in recolourable generated fabrics, from denim, linen, leather and camo to woven and printed patterns.
  • Hair and looks: MakeHuman hairstyles plus buzz cut, punk mohawk, cornrows and box braids. Stubble, mustache, goatee and beards. Tattoos. Earrings.
  • Faces that come alive: blinking and glances, 9 expressions with teeth and tongue, a talking clip and lip-sync mouth shapes, exported as blend shapes.
  • Auto-rigging: game rig (Mixamo bone names; Unity Humanoid / Unreal / Mixamo compatible), lite or full skeleton, A- or T-pose, optional face bones, a WeaponR socket.
  • 216 animations: motion-captured walk, model walk (catwalk), run and turns; jumps; unarmed fighting (punch combos, kicks, blocks) and sword combos; gunshot reactions (head, chest, back, stomach, leg and arm) with blood in the preview and Studio; a full shooter set with cover, rifle hits and deaths; reactions and get-ups; pick up, press, open door, push and carrying (in the hands or on the head); everyday background actions (talking gestures, phone call, texting, leaning on a wall, looking around, sweeping); emotes and dances; sitting and lying; swimming, diving and climbing out; ladder climbing, vaulting and ledge climbing; forward roll and side dodges; parachuting; and vehicles. Optional root motion. What you see in the preview is what you export.
  • Props: a rifle, pistol, sword, knife and grenade (exported in the hand or as separate props), bags, a parcel, a phone, a broom, a head-load basin, an animated parachute, and a ladder, vault obstacle, ledge wall and cover wall for the climbing and cover clips.
  • Vehicles: fourteen customizable vehicles fitted to the rider: bicycle, classic convertible, modern sports car, SUV, pickup, motorcycle, horse, canoe, kayak, rowing boat, motorboat, helicopter, military tank and jet. Each has boarding and alighting; there are stunt rolls, crash escapes, jet taxi/take-off/landing, parachute bail-outs and a tank machine gunner. Riders can wield guns or blades. Export vehicles separately in GLB, FBX or OBJ. In Studio they travel through sets, share seats between characters and stay parked after use.
  • Exports you can trust: an export panel that lists every file before you download it: static, rigged, or rigged + animations; one file or one per clip; Unity model@clip and Godot loop naming.
  • Share: a branded image of your character, a caption and a link that rebuilds the exact character in the app (no server or account needed).

Ara 3D Studio

  • Films: open your character in /studio/, search 66 categorized sets, direct up to five preset or saved custom characters with 216 animations, orbit the scene, add subtitles or comic bubbles that follow characters, and add typed, recorded or uploaded speech with voice effects, timed sound effects and nine recorded music options. Export a 720p or 1080p MP4 with sound. Studio guide.

Ara Play

  • Missions: escape, rescue and clear across five locations, with objectives to reach, download, defend, eliminate, survive, escort, chase and convoy.
  • Companions and vehicles: free a companion who follows you and rides along; 14 drivable vehicles.
  • Combat: pistols, rifles and grenades, cover, stealth takedowns, snipers, heavies and squad leaders.
  • A city between chapters: free roam with traffic, pedestrians, police and a wanted level, side jobs and a car radio.
  • Arcade races: 11 circuits, 13 cars, drifting, nitro, items, ghosts, cups and expert rivals.
  • Endless runs: 11 settings, 7 power-ups including spring boots and a hoverboard, objects to find and armed enemies to shoot.
  • Campaigns and story: up to ten chapters in any mix of modes, with branching choices, dialogue, voices and opening and ending films.
  • Customize: set the game's name, How to play and colours.
  • Publish online: live on Cloudflare in about a minute with no sign-up, ready to claim into your own free account; or download the game and host it anywhere. Hosting your game.
  • No code: everything is set in the editor. Play guide.

Across the apps

  • LLM Assist and Studio's Assist: copy a complete guide from the character builder or Studio into your preferred AI assistant, then paste or open its JSON to build a character or an editable film with a custom-designed cast. Studio includes downloadable staging maps for all 66 sets: water boundaries, paths, seats, obstacles, reference routes and a harbour boarding pier. Check staging reviews complete paths and exports fitted transition coordinates. It prepares scripted voices while you review the result. No API key needed.
  • Tested: npm test builds 407 characters and validates every format; npm run test:gltf checks every bone of every clip in three.js; npm run test:ui drives the app in headless Chrome.

Quick start

Just need characters? No clone needed. With Node 20+:

npx ara3d export --preset "The Soldier"            # GLB in ./ara3d-out
npx ara3d export --random 1-50 --formats glb,fbx  # 50 different characters

See Command line (ara3d) for character files, schemas and every option.

Building a web app or game? Generate characters at runtime with three.js:

import { createCharacter } from 'ara3d';
const hero = await createCharacter('The Soldier', { animations: ['walk', 'idle'] });
scene.add(hero.scene);

See JavaScript library (ara3d).

Want a character on your website? One tag, no build tools:

<script type="module" src="https://cdn.jsdelivr.net/npm/ara3d@0/dist/embed.js"></script>
<ara-character preset="The Soldier" animation="rifle_idle" weapon="rifle"></ara-character>

See Embed a character, or choose Share → Copy embed code in the builder.

Using an AI assistant? claude mcp add ara3d -- npx -y ara3d mcp lets Claude (or Cursor, VS Code and others) make characters for you. See AI assistants (MCP).

Run the whole site locally. Works on Windows, macOS and Linux. Requirements: Node 20+ and git.

git clone --depth 1 https://github.com/olatunde85/3d-gen.git
cd 3d-gen
npm install
npm run setup-assets   # one-time: downloads CC0 MakeHuman data (~420 MB), builds public/assets (~50 MB) and fetches the site videos
npm run dev            # open http://localhost:5173 (landing page; the app is at /app/)

--depth 1 downloads only the current files (about 50 MB) instead of the full history; drop it if you want every past commit.

Already cloned it? Update with git pull, npm install, then npm run setup-assets (about a minute; it reuses your downloads). Building, deploying and the command line are covered in Self-hosting.

Documentation

The full guides live in docs/, also at ara3dgen.com/docs:

Questions and showcases: Discussions. Bugs and ideas: Issues. What changed in each version: Releases.

Licensing

  • Code: MIT.
  • Studio music: nine recorded tracks supplied for Ara, compressed and loudness-matched with FFmpeg. Creator/source credits ship in media/music/CREDITS.txt; music retains its own rights and is not covered by the code licence.
  • Studio speech tools: optional local Supertonic 2 voices use separately downloaded OpenRAIL-M model files; ONNX Runtime Web is MIT. Native device voices are available for read-throughs. Notices ship in third-party/speech/; see the Studio guide.
  • Studio video tools: Mediabunny is MPL 2.0. Static builds include its licence and original source in third-party/mediabunny/; see the Studio guide.
  • Character data: MakeHuman assets, CC0 1.0 (public domain); see scripts/ASSETS_LICENSE.txt. They are downloaded by setup-assets, not stored in this repository.
  • Motion capture: the captured clips come from the CMU Graphics Lab Motion Capture Database: free to use, including in commercial products, but the data may not be resold on its own. The data used in this project was obtained from mocap.cs.cmu.edu. The database was created with funding from NSF EIA-0196217. The retargeted clips are baked into src/core/anim/clips/mocap-data.ts by npm run build-mocap (takes are listed in scripts/mocap-takes.ts).
  • Your exports: yours. Use them in commercial and non-commercial projects without attribution.

Contributing

Garments, hairstyles, animations, presets, engine notes, docs and bug reports are all welcome: see CONTRIBUTING.md.

Roadmap

See the open issues, for example more animations (cultural dances) in #1 and face capture with Apple's 52 ARKit shapes in #11.

Yorumlar (0)

Sonuc bulunamadi