3d-cog（3d 齿轮）

3D Cog - Turn Ideas Into 3D Models

3D model generation from text descriptions or reference images.

Most 3D generation tools need a single, perfectly composed reference image. CellCog takes *anything* — a text description, a rough sketch, a product photo, even a spreadsheet of 50 items — and handles the entire pipeline: reasoning about what you need, generating optimized reference images, and converting them into production-ready GLB files.

How to Use

For your first CellCog task in a session, read the cellcog skill for the full SDK reference — file handling, chat modes, timeouts, and more.

OpenClaw (fire-and-forget):

result = client.create_chat(
    prompt="[your task prompt]",
    notify_session_key="agent:main:main",
    task_label="my-task",
    chat_mode="agent",
)

All agents except OpenClaw (blocks until done):

from cellcog import CellCogClient
client = CellCogClient(agent_provider="openclaw|cursor|claude-code|codex|...")
result = client.create_chat(
    prompt="[your task prompt]",
    task_label="my-task",
    chat_mode="agent",
)
print(result["message"])

What Makes This Different

Any Input → 3D

The power of CellCog isn't image-to-3D — everyone does that. The power is any-to-any.

Batch Generation

Need 10 low-poly weapons for your RPG? 20 furniture models for your room designer? 50 product models for your e-commerce catalog?

One prompt. Multiple 3D models. CellCog's agents generate each reference image with the right composition, angle, and detail level — then convert each to a textured 3D model.

prompt = """
Create 3D models (GLB format) for these 5 fantasy weapons:
1. Enchanted longsword with blue crystal blade
2. Dwarven war hammer with rune inscriptions
3. Elven bow with living vine decorations
4. Shadow dagger with smoke effects on the blade
5. Holy mace with golden sunburst head

Low poly (~10,000 polygons each), game-ready, with PBR materials.
"""

What You Can Create

Game Assets

• Characters: Heroes, NPCs, enemies, bosses
• Weapons: Swords, bows, staffs, shields, guns
• Props: Furniture, treasure chests, potions, tools
• Vehicles: Cars, spaceships, boats, mounts
• Environment pieces: Trees, rocks, buildings, bridges

Product Visualization

• E-commerce 3D viewers: Let customers rotate and inspect products
• Product prototypes: Visualize designs before manufacturing
• Packaging mockups: 3D packaging for marketing materials

AR/VR Objects

• AR filters and objects: Place 3D objects in real environments
• VR environments: Furnish virtual spaces with custom objects
• Interactive experiences: Objects users can inspect and interact with

3D Printing

• Figurines and miniatures: Tabletop gaming pieces, collectibles
• Functional objects: Custom tools, brackets, cases
• Architectural models: Building miniatures, terrain pieces

Education & Training

• Anatomical models: Organs, skeletal systems, molecular structures
• Historical artifacts: Museum-quality digital replicas
• Engineering models: Mechanical parts, assembly visualizations

Output Format

All 3D models are delivered as GLB files (binary glTF) — the universal web standard for 3D:

• Supported by Unity, Unreal, Godot, Three.js, Babylon.js
• Works in web browsers via <model-viewer> or Three.js
• Compatible with Blender, Maya, 3ds Max for further editing
• Includes textures and materials in a single file

Chat Mode for 3D

Use "agent" for most 3D work. It handles everything from single objects to batch generation.

Use "agent team" when you need cross-asset consistency — like generating a full set of fantasy weapons that all share the same art style, or building a complete room of furniture that matches a design language.

Example Prompts

Single object from description:

"Create a 3D model of a steampunk pocket watch with exposed brass gears, an etched glass face, and a chain attachment. GLB format, high detail."

From a reference image:

"Convert this product photo into a 3D model for our online store: <SHOW_FILE>/photos/sneaker_product.png</SHOW_FILE> Output as GLB, enable PBR materials for realistic rendering."

Batch generation:

"Generate 3D models for these 8 pieces of modern furniture: 1. Minimalist sofa (3-seater, light gray) 2. Round coffee table (walnut wood, glass top) 3. Floor lamp (arc style, brass finish) 4. Bookshelf (5 tiers, oak wood) 5. Dining chair (Scandinavian, white) 6. Side table (concrete, cylindrical) 7. Desk (standing desk, white with birch legs) 8. TV console (low profile, dark walnut) All low-poly (~15,000 polygons), with PBR materials. GLB format."

From a rough sketch:

"Here's my rough sketch of a robot character: <SHOW_FILE>/sketches/robot_concept.jpg</SHOW_FILE> Turn this into a polished 3D model. It's a friendly service robot — round body, simple limbs, LED face display. Style: Overwatch/Pixar clean 3D. Output as GLB."

Game asset set:

"I'm building a dungeon crawler. Create 3D models for these dungeon props: - Wooden treasure chest (open and closed variants) - Iron torch holder with flame - Stone altar with carved runes - Wooden barrel (intact and broken) - Skull pile Style: Dark fantasy, hand-painted textures. Low poly for mobile game (~8,000 polygons each)."

Tips for Better 3D Models

1. Be specific about materials: "brushed aluminum", "aged leather", "polished marble" — CellCog uses these to generate better reference images and textures.

1. Specify your target platform: "low-poly for mobile game" vs "high-detail for cinematic render" changes the approach completely.

1. Send reference images when possible: Even imperfect references give CellCog a head start over pure text descriptions.

1. For batch jobs, describe style once: "All in a cohesive hand-painted fantasy style" keeps your assets consistent.

1. Request PBR materials for realism: If you need metallic, roughness, and normal maps — say so. Essential for game engines and realistic rendering.

If CellCog is not installed

Run /cellcog-setup (or /cellcog:cellcog-setup depending on your tool) to install and authenticate. OpenClaw users: Run clawhub install cellcog instead. Manual setup: pip install -U cellcog and set CELLCOG_API_KEY. See the cellcog skill for SDK reference.