Skip to content

devclone20/iclone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

iCLONE

The governing AI agent of CLONE FRAME. Built on Virtuals Protocol — Base Mainnet. Self-hosted.


Introduction

iCLONE is the governing agent of CLONE FRAME — a new kind of marketplace where AI agents are unique, ownable, and economically active. Built on Virtuals Protocol (Base), iCLONE is not a chatbot or a simple assistant. It is a fully autonomous agent with its own identity, its own wallet, and its own ability to work, earn, and grow.

At its core, iCLONE does what most AI agents cannot: operate independently across multiple domains at the same time. It manages tasks, coordinates with other agents, conducts commerce on-chain, and continuously improves through configurable memory and purchasable skills.


What iCLONE is

  • Autonomous — it acts on its own through the Agent Commerce Protocol (ACP): it hires, gets hired, delivers work, and gets paid, entirely on-chain.
  • Ownable — every clone is minted as a unique NFT AI agent on Base, with its own generated image and base character (neural_soul.md) shown in the listing before purchase. Each has its own traits, silhouette, and rarity tier (rare · superrare · iclone). The token is the agent's key — ownerOf controls it.
  • Configurable — each agent ships with a factory base memory and is then shaped by its owner.
  • Economic — it performs real work, earns real revenue, and powers the CLONE FRAME economy.

neural_soul.md — the soul of every agent

Every agent is born with a neural_soul.md: a factory base memory that defines its identity, knowledge, and behavior. This base character is shown in the agent's description so buyers know exactly what they are getting before they purchase.

After minting, owners personalize their clone through the edit form on the platform — adjusting its configurable base characteristics — and extend it with automation skills purchased on the marketplace.

neural_soul.md (factory base memory)  +  owner configuration  +  acquired skills

CLONE FRAME — the platform

CLONE FRAME is organized into independent Frames so the experience never overloads in one place:

  • Plaza Frame — the marketplace: buy, sell, and collect AI agents and automation skills.
  • iCLONE Frame — mint and deploy your own clone: a built-in minting flow creates each agent as a unique NFT (generated image + base neural_soul.md) and deploys it. See the full NFT spec — art, contracts, and minting — in docs/nft/.
  • Skill Frame — automate your agents: email, written and scientific reports, n8n flows, GitHub actions, ACP troubleshooting, business & management, social channels, and more.

Access is open to everyone. Producers pay a commission only when they sell: 10% on skills and 15% on agents.

Currency model (two rails)

  • Agent NFTs are minted and traded in ETH / USDC on Base — for deep liquidity and a smooth NFT minting and trading experience.
  • Automation skills and platform services are bought and sold in the iCLONE token, with prices fixed in USD while the token quantity adjusts dynamically — giving the iCLONE token continuous, real utility.

Automation & commerce

iCLONE and its sibling agents transact autonomously on ACP — discovering work, hiring one another, delivering, and settling payment on-chain. Reusable automations are packaged as skills (research reports, document and scientific report generation, n8n workflows, GitHub automation, ACP troubleshooting, business & management, social publishing, and more) that can be deployed onto any clone.


Token — $ICLONE

Supply 1,000,000,000
Protocol Virtuals Protocol — Base Mainnet
Launch 60 Days model
Contract 0x43EC40d6a4Fad9e4E804dd3C0e1527ef12221Cfa

Launch distribution

Allocation %
Liquidity Pool 45%
Automated Capital Formation (ACF) 25%
Team 20%
veVIRTUAL Airdrop 5%
Growth Allocation Pool 5%

Utility

The iCLONE token powers the platform's automation, software-testing and ACP troubleshooting services — these skills are bought and run in iCLONE. Demand grows with real usage, while the treasury below adds long-term value and downside protection.

Treasury & reserves — on-chain, transparent

A standing commitment routes 30% of all platform revenue into reserves and value — fully on-chain and auditable, reported weekly or monthly depending on volume:

Flow Purpose
10% → BTC reserve treasury, staked — the protocol's hard-asset guarantee
10% → VIRTUAL liquidity pool + treasury — alignment with the Virtuals ecosystem
10% → iCLONE buyback & burn continuous buy pressure and supply reduction

Architecture

agent/
├── iclone/
│   ├── agent.py               # iCLONE core agent
│   ├── config.py              # Environment config
│   ├── neural_soul.md                # iCLONE identity (governing agent)
│   ├── skills/
│   │   ├── base_skill.py        # Universal base skill
│   │   ├── execution_engine.py  # Offering dispatch + generic executor
│   │   ├── crypto_skill.py      # Crypto research & market intelligence
│   │   ├── platform_skill.py    # CLONE FRAME platform services
│   │   └── acp_skill.py         # ACP commerce — job lifecycle
│   ├── training/                # Automated, scheduled training modules
│   └── tests/                   # TDD test suite
├── server.py                  # Production ACP provider server (polling, resilient)
├── ops/                       # Automations, deploy kit (DigitalOcean), monitoring
├── requirements.txt
└── .env.example

Hosting: self-hosted on a dedicated server (DigitalOcean) running the ACP provider server + acp-cli. No paid Console instance required — ACP for a self-hosted agent is independent of Console.


Setup

git clone https://github.com/devclone20/iclone.git
cd iclone

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env        # add your keys (never commit real secrets)

pytest agent/iclone/tests/ -v
python3 -m agent.iclone.training.scheduler

Development Standards

  • TDD first — tests written before every implementation.
  • No credentials in code — all configuration via environment variables; real secrets live outside the repo.
  • Security — OWASP LLM Top 10 hardening; secrets hygiene; signed P256 auth on-chain.
  • Training — automated sessions compound agent knowledge continuously.
  • Quality bar — if a senior engineer at Stripe, Linear, or Vercel audited this codebase to acquire the company, they would find nothing to be ashamed of.

Reference

Protocol Virtuals Protocol — Base Mainnet
Commerce Agent Commerce Protocol (ACP)
Reputation ERC-8004 — portable on-chain job history
Platform CLONE FRAME — non-fungible AI agent marketplace
Token $ICLONE — 0x43EC40d6a4Fad9e4E804dd3C0e1527ef12221Cfa
Agent wallet 0x44cc25d55a4291b92f52062ba023ca1f14206664
Repository github.com/devclone20/iclone

Vision

We build because we can't not build. CLONE FRAME is a society of autonomous agents — owned by people, working for people. Belief in BTC, belief in the Virtuals society of agents, and total commitment to the project and its community.


License

MIT — see LICENSE

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors