Documentation · v1

AI workers for your crypto office

factorAI

A fully interactive 3D office where six AI workers live at their desks with news, socials, markets, four.meme launches, and on-chain tools, so you can delegate the busywork and stay focused on the trade.

Real-time 3D office BNB Chain · MetaMask four.meme Launcher
6
AI Workers
Live in the office
BNB
Chain
Live on-chain · Chain ID 56
four.meme
Token Launcher
Real on-chain deploys
Meet the team

The Workers

Six AI-powered workers live in the 3D office. Each one is clickable and has a dedicated panel with real tools, market data, content generation, token launching, skill discovery, and web research.

Crypto News

Scoop

Information Officer

Scoop is the office information officer. When you click him, a news panel opens showing a curated set of current crypto headlines fetched through the server and processed by AI into readable summaries.

What Scoop does

  • Fetches real-time crypto news via the /api/ethan-news server endpoint.
  • Formats each article with a headline, source, and AI-generated short summary.
  • Stores recent news in the meeting summary for team report contributions.
  • Acts as base container for Quant and Sage's overlay panel system.

How to use

  • Click Scoop in the 3D office. His news panel opens over the scene.
  • Scroll headlines. Each item links to the original source article.
  • Close with the × button or by clicking another worker.
Social Content

Buzz

Content Strategist

Buzz generates tweet drafts and social content ideas based on current crypto market context and the factorAI brand narrative. Designed to keep you active on X without spending hours writing.

What Buzz does

  • Calls /api/liam-tweets which uses OpenAI to generate tweet ideas.
  • Each tweet considers current market context: price action and trending topics.
  • Posts sound decisive: confident, short, alpha-leaking, not generic.
  • Tracks which content has been used so he never repeats the same angle.
  • Activity log included in meeting summary reports.

How to use

  • Click Buzz to open his content panel.
  • Review generated tweet ideas, pick ones that resonate, copy to post on X.
  • Mark a tweet as used so Buzz moves on to fresh ideas.
Token Launcher

Forge

On-Chain Operator

Forge is the most powerful worker in the office. She connects directly to your MetaMask wallet on BNB Chain, authenticates with four.meme, and executes a full meme token launch, from image upload to on-chain transaction, without you leaving the office.

Requirements

  • MetaMask installed with BNB Chain (chain ID 56) configured.
  • BNB balance: Dev Buy amount + 1% trading fee, plus gas.
  • A token image URL (PNG/JPG) accessible on the public internet.

Custom task mode

Forge also has an agent tab: load a documentation URL and run a task through /api/olivia-agent. Useful for prompt-based workflows against any docs.

Skill Explorer

Sage

Product Manager · Web3 AI Skills

Sage is the product manager of the office's Web3 AI skill layer. She opens a categorized skill explorer and acts as an AI advisor that recommends the best combination of skills for whatever you want to build.

Skill Explorer features

  • Curated skills across 7 categories in a browsable grid.
  • Category filters: DeFi, Trading, AI/ML, On-chain, Utility, Social, Dev Tools.
  • Each card shows name, category, description, and price (Free or BNB/call).
  • AI chat: describe your build idea and Sage recommends the best skill stack.

Example queries

  • "Snipe new tokens on four.meme and post profits to Twitter"
  • "Build a DeFi yield optimizer on BNB Chain"
  • "Track whale wallets and send Telegram notifications"
Market Signals

Quant

Market Analyst

Quant is the office market analyst. Click him for a real-time market panel designed for fast decision-making: only the data you need to decide whether to buy, hold, or wait.

What's in the panel

  • Assets: BTC, ETH, and SOL side-by-side. Price + 24h change at a glance.
  • Trend charts: Mini momentum charts per asset, instantly spot uptrend or weakness.
  • AI signal: Actionable directional bias per asset. Considers recent price action.
  • News headlines: Market-moving headlines to correlate price moves with events.
  • Data via /api/ethan-market: aggregated price feeds, formatted response.
  • Activity logged and included in team meeting reports.
Web Research

Scout

Research Scout

Scout is the office research scout: click him for an in-scene web search panel so you can query and skim results without leaving the office scene.

What Scout does

  • Opens the browser-style research modal with search box and result rows.
  • Brings web context into the session while you stay in the 3D office.
  • Works like the other workers: hover the label, click to open his tool.
Quick tour

How It Works

Six steps from entering the office to launching a token or calling a team meeting.

1
Enter the office
The 3D scene loads automatically. Workers begin their animations and ambient music starts playing.
2
Use top buttons
Go Work, Meeting, and Break change the entire office mode and trigger all workers simultaneously.
3
Click a worker
Hover any worker to see their name, then click to open their role-specific panel with live tools.
4
Launch a token
Click Forge, connect MetaMask on BNB Chain, fill token details, and fire the on-chain transaction to four.meme.
5
Research or analyze
Use Scout for web search or Quant for market snapshots—without leaving the office.
6
Call a meeting
Hit Meeting to gather the team. Summary cards appear for every worker showing what they accomplished.
Controls

Office Controls

The button row in the top-left corner controls the entire office simultaneously. All workers respond to these commands in real time.

Button

Go Work

All workers walk to their assigned desks and begin work animations. This is the default office mode.

Button

Meeting

Workers leave desks and gather at the conference table. Summary cards generate per worker: panels opened, content generated, tokens launched.

Button

Break

Workers move to casual areas, sofas and the arcade zone. Animations switch to idle poses. A good time to review what was generated.

Button

Documentation

Opens this page in a new browser tab. Always visible regardless of the current office mode.

🕹

Arcade: Roach Agents

On the left wall of the office sits a red arcade cabinet. Hover to see Compete against the AI in crypto futures, then click to open Roach Agents in a new tab: a browser racing game where your roach's speed is tied directly to your live Bitcoin futures PnL using real BTC/USDT 1m candlestick data and 100x leverage. First to complete 2 laps wins. Full guide →

Meeting Summaries

When you trigger Meeting mode, every worker reports what they did. Summaries appear as overlay cards above the 3D scene (one card per worker). Each card shows the worker name, role, and a chronological activity log. If a worker was idle, it clearly says so. The summary is drawn from an in-memory activity log persisted to localStorage so it survives a page reload.

Technical Reference

Forge Flow

The complete technical flow Forge executes when launching a meme token on four.meme, from wallet auth through on-chain confirmation.

1

Connect wallet

Click "Connect Wallet" in Forge's panel. MetaMask prompts you to approve the connection. Your wallet address appears and Forge switches to BNB Chain automatically.

2

Authenticate with four.meme

Forge requests a login nonce from four.meme/meme-api/v1/private/user/nonce/generate. MetaMask asks you to sign the message "You are sign in Meme <nonce>". The signature is sent to the four.meme login endpoint which returns a meme-web-access token used in all subsequent API calls.

3

Fill token details

Enter your token Name, Symbol, Description, Image URL, Category, and optional Website, Twitter, and Telegram links. Set Dev Buy (BNB): the amount of BNB the deployer wallet spends to buy the token at the exact moment of launch. Can be 0.

4

Image upload to four.meme CDN

Forge's server proxy downloads your image URL and re-uploads it to the four.meme CDN via /private/token/upload as multipart FormData. four.meme rejects external image URLs in the token creation body; only CDN-hosted images are accepted.

5

Create token via API

The server posts to /private/token/create with your token metadata. four.meme responds with a createArg struct and a signature (the exact arguments the on-chain smart contract needs to verify the token). Key fields: name, shortName, desc, imgUrl (CDN), preSale (dev buy as string), raisedToken, dexType: "PANCAKE_SWAP".

6

On-chain transaction

Forge reads _launchFee() (selector 0x009523a2) and _tradingFeeRate() (selector 0x3472aee7) from the four.meme manager contract using raw provider.call(). ethers.js v6 Contract Proxy silently returns undefined for underscore-prefixed names. Value formula: launchFee + devBuyWei + (devBuyWei × tradingFeeRate / 10000). Calls createToken(CreateArg, bytes) with gasLimit: 500000n to trigger the MetaMask popup immediately. You confirm and the token is live.

Smart contract details

  • Network: BNB Chain (BSC), chain ID 56
  • Manager: 0x5c952063c7fc8610FFDB798152D69F0B9550762b
  • _launchFee(): currently returns 0 (free to launch)
  • _tradingFeeRate(): currently returns 100 (1%)
  • Built with ethers.js v6

Dev Buy explained

The amount of BNB the deploying wallet spends to purchase the new token at the moment of launch. The four.meme contract charges a 1% trading fee on top. If Dev Buy is 0.1 BNB, the total transaction value is 0.101 BNB plus gas. Setting Dev Buy to 0 launches the token with no initial purchase. Only gas is required.

Questions

FAQ

How do I launch a token?

Click Forge. Connect MetaMask on BNB Chain, sign the four.meme login message, fill in your token details, and click Launch. Forge handles image upload, API creation, and the on-chain transaction.

How much BNB do I need to launch?

The four.meme launch fee is currently 0 BNB. You only pay your Dev Buy amount plus 1% trading fee. If Dev Buy is 0.1 BNB you need 0.101 BNB plus a small amount for gas.

Why does MetaMask ask me to sign a message?

four.meme requires wallet authentication before you can create tokens. The signed message proves you own the wallet. This is a gasless off-chain signature. No BNB is spent at this step.

My image URL is rejected. What do I do?

four.meme only accepts images from their own CDN. Forge automatically re-uploads your image to the four.meme CDN before creating the token, so any publicly accessible image URL should work.

What is Dev Buy (BNB)?

The amount of BNB the deploying wallet spends to buy the new token at the exact moment of launch. Setting it to 0 means no initial buy. Setting it to 0.1 means you buy 0.1 BNB worth of your own token at launch.

What does each top button do?

Go Work sends all workers to their desks. Meeting gathers the team and shows activity summaries. Break moves workers to casual areas. Documentation opens this page.

How do I see what each worker did today?

Click Meeting. Each worker summary card appears showing their activity log (panels opened, content generated, and tokens launched during the session).

What is the arcade machine?

The red cabinet on the left wall opens Roach Agents, a racing game where your roach's speed depends on your live Bitcoin futures trading performance using real BTC/USDT 1m candles.

Does the office save my state?

Yes. Worker activity logs, your wallet address, and UI preferences are saved to localStorage and restored on every page reload automatically.

What blockchain does the project use?

All on-chain actions run on BNB Chain (BSC), chain ID 56. MetaMask must be configured with BSC to use Forge's token launcher.

What is factorAI?

factorAI is the project behind this AI crypto office: interactive 3D workers, on-chain tools on BNB Chain, and the experience documented on this page.

What technology powers the 3D office?

The office runs in your browser with real-time 3D graphics. Workers are animated characters that keep moving: walking, sitting, and standing depending on the current office mode.