Skip to content

jackatwire/Docs

BranchesTags
 
 

Repository files navigation

Morpheus

A Network For Powering Smart Agents

Authored by Morpheus, Trinity, & Neo

Published - September 2nd 2023

Introduction

The Smart Agent concept of connecting LLMs and AI Agents to wallets, Dapps, & smart contracts promises to open the world of Web3 to everyone. Chatting in normal language with your Smart Agent and having it understand the question or task, is similar to how Google's search engine opened the early internet up to the general public.

To make Smart Agents accessible to everyone and increase decentralization we propose a network & fairly launched token for incentivizing all four of the key contributors to their operation. Namely, the community of users, coders contributing to the Morpheus software / agents, capital providers funding development / operations and those supplying computation, storage and bandwidth. It has been well shown by the history of Bitcoin and Ethereum that free & open competition for scarce digital tokens can provide scalable infrastructure for a public blockchain over long periods of time.

Smart Agent Development Principles:

  • Agents cannot execute decisions.
    Agents can only construct transaction payloads for a user's approval.

  • Local installation.
    Agents should run on the user's laptop, typically with 8-16 GB of RAM. This allows for faster execution and better performance.

  • No private keys.
    Agents must not have access to private keys or be able to execute transactions independently. User's cryptographic approval is essential for any transaction.

Morpheus Local Smart Agent Features v.0.0.8

Current

  • Fetch price, market cap, and TVL of coins and tokens supported on CoinGecko.
  • Web interface.
  • Wallet integrations for your existing wallets in-browser:
    • MetaMask
    • Rainbow
    • Coinbase Wallet
    • WalletConnect
  • Web3 swap agent (macOS only).

Pending

  • Chat with local files agent (general purpose)

Example queries

After connecting Morpheus with your web3 wallet, you can test the Data Smart Agent with prompts such as:

  • What is my balance?

  • What is my address?

  • Send ETH to [Ethereum Address]

  • What is the price of Ethereum / Price of ETH (or other token listed on Coingecko)

  • What is the market cap of DOGE / MC of DOGE (or other token listed on Coingecko)

  • What is the fully diluted valuation of Solana / FDV SOL (or other token listed on Coingecko)

  • What is the total value locked in Uniswap / TVL of Uniswap (or other token listed on Coingecko)

For the Swap Smart Agent, a typical flow looks like this:

  • A user requests a swap, e.g "I want to swap ETH for WBTC".

  • The agent requests any missing information, e.g. in this case the amount is missing.

  • Once all the information has been collected, the agent looks up the assets on the current chain, retrieves contract addresses and generates a quote if available.

  • The quote is shown to the user, who may either proceed or cancel.

  • If the user accepts the quote, the swap may proceed. The back-end will generate transactions which will be sent to the front-end to be signed by the user's wallet.

  • If the allowance for the token being sold is too low, an approval transaction will be generated first.

Warning

Review all transactions before approving them. The LLM makes mistakes, you have human wisdom.

Seriously, double check all actions in the Metamask interface before sending money.

This is an experimental release and the ETH Smart Agent may try and send your money into a black hole.

Gas costs are high on Ethereum. Consider testing out 0.0.8 using the Sepolia testnet or Arbitrum.

Installs

Mac OS M1/2/3 etc. (arm64)

Note

minimum 16GB RAM

  1. Download and install Docker Desktop.

  2. Follow default settings, can skip surveys, then leave docker desktop running. You can minimize it.

  3. Download Moragents.zip.

  4. Open ZIP, and copy MORagents.app to your Applications folder.

    SHA256 96c2510e4f7a752c613b322be0a107958ee34814415e3e7b950b426298379a7a MORagents.zip

  5. Open MORagents app. Give it a few minutes the first time and then it should open your browser.
    If there's an issue, try opening the MORagents app again.

macOS Intel (x86_64)

coming soon

Windows (x86_64)

Note

Minimum 16GB RAM is required.

  1. Use Chrome to download MORagentsWindowsInstaller.zip

    SHA256 0a5f5e3a288d45854c83994fa4afa4c713019229d99d67f28442fc56a5de1b20 MORagentsWindowsInstaller.zip

  2. Go to downloaded MORagentsWindowsInstaller(.zip) file and click to "Extract All".

  3. Open Extracted Folder MORagentsWindowsInstaller. You may need to disable your anti-virus software before proceeding.

  4. Click and Run MORagentsSetup.exe This will auto-install Docker Desktop dependency.

  5. Open MORagents from Desktop.

  6. Accept Docker's EULA Surveys are optional, can skip

  7. Wait for Docker engine to start...

  8. Open MORagents App from Desktop First time installation requires some extra time to load agent's image.
    If anything hangs for >10min, please try opening the MORagents app again from the Desktop.

Linux

coming soon

Build it Yourself

  1. MacOS
  2. Windows

Troubleshooting

If the app shows connections errors to agent fetcher. Please ensure Docker Desktop is running, then close and reopen MOR Agent from desktop.

Key documents list:

Code:

Morpheus Smart Contract addresses:

Ethereum:

Arbitrum:

Base:

Morpheus Network Diagram

About

Technical Documentation

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • M 100.0%