Skip to content

HELLO.md

Latest commit

 

History

History
157 lines (103 loc) · 4.01 KB

HELLO.md

File metadata and controls

157 lines (103 loc) · 4.01 KB

Hello World — RAPP in 10 Minutes

10 commands. 10 minutes. You'll never look at software the same way again.

1. Summon a digital twin from 18 characters

python rapp_sdk.py card resolve @rapp/basic_agent

That's the root of everything. 18 characters. No database. No server. No network. The card self-assembled from just the name.

2. See it's the same on every computer in the world

python rapp_sdk.py card resolve @rapp/basic_agent --json

Run this on your laptop. Run it on your phone. Run it on a computer in Tokyo. Same seed. Same stats. Same flavor text. Same card. Math doesn't change.

3. Build your own agent in 5 seconds

python rapp_sdk.py new @yourname/my_first_agent

One command. You now have a working AI agent with its own trading card, manifest, documentation, and identity — all in one file.

4. Prove it works — run all 9 contract tests

python rapp_sdk.py test agents/@yourname/my_first_agent.py

9 tests. They should all pass. Your agent was born valid.

5. Mint your card

python rapp_sdk.py card mint agents/@yourname/my_first_agent.py

Your agent is now a card. Power, toughness, rarity, flavor text — all deterministically generated from the name you chose. You didn't design it. The algorithm did.

6. Search the registry

python rapp_sdk.py search "sales"

Every agent in the ecosystem with "sales" in its DNA. 131 founding agents across 19 categories.

7. Check the full registry status

python rapp_sdk.py binder status

Total agents, breakdown by tier, total value. Your view of the entire ecosystem.

8. Resolve any card from just a name

python rapp_sdk.py card resolve @kody/deal_desk_agent

22 characters. Full card. Try any agent name in the registry. They all self-assemble.

9. Validate any agent

python rapp_sdk.py validate agents/@rapp/basic_agent.py

Checks the manifest, the name format, the version, the structure. Valid or not — instant answer.

10. The one that changes everything

python -c "
from rapp_sdk import resolve_card
card = resolve_card('@rapp/basic_agent')
print(f'''
This card was reconstructed from 18 characters.
No image was downloaded. No database was queried.
No server was contacted. No blockchain was checked.

Name:    {card['name']}
Rarity:  {card['rarity_label']}
Power:   {card['power']}/{card['toughness']}
Flavor:  \"{card['flavor']}\"
Seed:    {card['seed']}

Run this on a phone in the woods with no WiFi.
Same card. Every time. Forever.

That is the invention.
''')
"

What just happened?

You just:

  1. Resolved a digital twin from a name string — no network needed
  2. Proved it's deterministic — identical on every device on earth
  3. Created a working AI agent in one command
  4. Tested it against 9 contract validations
  5. Minted its trading card — generated by the algorithm, not by you
  6. Searched a live registry of 131+ agents
  7. Viewed the full ecosystem from your terminal
  8. Resolved another card from 16 characters
  9. Validated an agent's structure and manifest
  10. Understood the invention: self-assembling software identity

Get started

  • Install the RAPP Brainstem — local-first AI agent server, cloud or local AI, your choice
  • Try the RAPP Brainstem vSandbox — run any agent in-browser, no install required
  • Browse the Agent Store — 131+ agents across 19 categories, click any card to flip it
  • Build something real: Edit your agent's perform() method to do actual work
  • Join the registry: Submit your agent via GitHub Issue and it enters the ecosystem

The three things to remember

  1. One file = software + card + asset + documentation
  2. One name = the complete card, on any device, offline
  3. One ecosystem = free to use, owned to collect

Welcome to RAPP.