Samah: Your Personal On-Chain AI Assistant

A Brand new Blockchain Experience

Introduction • What Can Samah Do for You? • How It Works • How To Use • Credits • Contracts Addresses •

Introduction

Meet Samah, your dedicated on-chain AI assistant designed to transform how you interact with the blockchain. Seamlessly blending cutting-edge AI capabilities with blockchain technology, Samah is here to make your digital life smarter, more efficient, and incredibly secure.

What Can Samah Do for You?

Chat with Intelligence:
Have a question? Need advice? Simply press Ctrl+L to summon Samah and start a conversation. Whether it's general inquiries or complex discussions, Samah is equipped to provide insightful responses.

Screenshot Analysis:
Ever wished you had an assistant who could see what you're doing on your desktop and offer real-time guidance? With Samah, that's possible. Activate the screenshot feature and let Samah understand and assist with your tasks directly. Press Ctrl+L, start the chat with the command /screenshot, and type what assistance you need.

Financial Guidance:
Navigating the financial landscape can be daunting. Samah offers expert financial advice, from managing bills to optimizing your crypto investments. Just start a chat with the command /analysis and get the insights you need. Show her your bills or crypto investments and let her do the rest.

Crypto Trading Simplified:
Say goodbye to complicated crypto trading processes. Samah can execute token swaps across different chains with ease. Just use the command /squid and specify your swap details in the format:

swap {amount} {fromToken} to {toToken} from {fromChain} to {toChain}

Example: /squid swap 1 FIL to USDC from Filecoin to Ethereum. Samah handles the rest, ensuring a smooth transaction.

Smart Swaps:
Unsure about the best trading strategy? Let Samah analyze your chat and suggest smart swaps tailored to your needs. Simply use the command /ss and let the AI do the heavy lifting. Example: /ss swap 3 MATIC to USDC on Polygon.

Beryx API Integration:
Get the most out of blockchain data with Samah’s access to the Beryx API. Whether you need the latest updates or specific blockchain queries, Samah can fetch the information for you. Start the chat with the command /beryx, and run queries. Example: /beryx what's the latest tipset?

Lilypad Integration:
To work with Lilypad, start the chat with /lilypad. Currently, only the chat functionality is supported.

How to Get Started

Backend Setup:

1. Navigate to the backend directory.
2. Run npm install to install the required packages.
3. Rename .env.template to .env and fill in your private key. Ensure you use the Galadriel faucet for funds.
4. Run npm run samah to start the backend server.

Note for Linux Users:
To enable screenshot functionality, install ImageMagick with the command: apt-get install imagemagick.

Note for Windows Users:
Lilypad only runs on WSL. Move the Lilypad server to WSL and run it from there. Additionally, change the API endpoint in the client from /lilypad to http://localhost:3400/lilypad.

Client Setup:

1. Navigate to the client directory.
2. Run npm install to install the required packages.
3. Run npm run start to start the client application.

Technology Used

• Electron Framework: Designed to create desktop applications using web technologies.
• Galadriel: The first L1 blockchain purpose-built for AI.
• Squid Router: Creates unlimited access for anything in crypto.
• Beryx: A dynamic web platform for developers working with blockchain technologies, particularly focusing on the Filecoin blockchain.
• Fleek: Provides essential tools for developers who want to build on a fully decentralized stack.
• Lilypad: Transforms AI by making distributed compute accessible.