merge

Author: dontAskVI

.env.example

@@ -18,6 +18,7 @@ GOOGLE_GENERATIVE_AI_API_KEY= # Gemini API key
 
 ALI_BAILIAN_API_KEY= # Ali Bailian API Key
 VOLENGINE_API_KEY=  # VolEngine API Key
+NANOGPT_API_KEY= # NanoGPT API Key
 
 HYPERBOLIC_API_KEY= # Hyperbolic API Key
 HYPERBOLIC_MODEL=
@@ -96,6 +97,11 @@ MEDIUM_GROQ_MODEL=     # Default: llama-3.3-70b-versatile
 LARGE_GROQ_MODEL=      # Default: llama-3.2-90b-vision-preview
 EMBEDDING_GROQ_MODEL=  # Default: llama-3.1-8b-instant
 
+# NanoGPT Configuration
+SMALL_NANOGPT_MODEL=   # Default: gpt-4o-mini
+MEDIUM_NANOGPT_MODEL=  # Default: gpt-4o
+LARGE_NANOGPT_MODEL=   # Default: gpt-4o
+
 #LlamaLocal Configuration
 LLAMALOCAL_PATH= # Default: "" which is the current directory in plugin-node/dist/ which gets destroyed and recreated on every build
 

.github/workflows/image.yaml

@@ -0,0 +1,61 @@
+#
+name: Create and publish a Docker image
+
+# Configures this workflow to run every time a change is pushed to the branch called `release`.
+on:
+    release:
+        types: [created]
+    workflow_dispatch:
+
+# Defines two custom environment variables for the workflow. These are used for the Container registry domain, and a name for the Docker image that this workflow builds.
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+# There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu.
+jobs:
+  build-and-push-image:
+    runs-on: ubuntu-latest
+    # Sets the permissions granted to the `GITHUB_TOKEN` for the actions in this job.
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+      # 
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      # Uses the `docker/login-action` action to log in to the Container registry registry using the account and password that will publish the packages. Once published, the packages are scoped to the account defined here.
+      - name: Log in to the Container registry
+        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about) to extract tags and labels that will be applied to the specified image. The `id` "meta" allows the output of this step to be referenced in a subsequent step. The `images` value provides the base name for the tags and labels.
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+      # This step uses the `docker/build-push-action` action to build the image, based on your repository's `Dockerfile`. If the build succeeds, it pushes the image to GitHub Packages.
+      # It uses the `context` parameter to define the build's context as the set of files located in the specified path. For more information, see "[Usage](https://github.com/docker/build-push-action#usage)" in the README of the `docker/build-push-action` repository.
+      # It uses the `tags` and `labels` parameters to tag and label the image with the output from the "meta" step.
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+      
+      # This step generates an artifact attestation for the image, which is an unforgeable statement about where and how it was built. It increases supply chain security for people who consume the image. For more information, see "[AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds)." 
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v1
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME}}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true
+      

agent/src/index.ts

@@ -270,6 +270,11 @@ export function getTokenForProvider(
                 character.settings?.secrets?.VOLENGINE_API_KEY ||
                 settings.VOLENGINE_API_KEY
             );
+        case ModelProviderName.NANOGPT:
+            return (
+                character.settings?.secrets?.NANOGPT_API_KEY ||
+                settings.NANOGPT_API_KEY
+            );
         case ModelProviderName.HYPERBOLIC:
             return (
                 character.settings?.secrets?.HYPERBOLIC_API_KEY ||

docs/docs/guides/local-development.md

@@ -94,6 +94,22 @@ pnpm run test:watch    # Run tests in watch mode
 pnpm run lint          # Lint code
 ```
 
+### Direct Client Chat UI
+
+```
+# Open a terminal and Start with specific character
+pnpm run dev --characters="characters/my-character.json"
+```
+```
+# Open a 2nd terminal and start the client
+pnpm start:client
+```
+
+Look for the message:
+`  ➜  Local:   http://localhost:5173/`
+Click on that link or open a browser window to that location.  Once you do that you should see the chat interface connect with the system and you can start interacting with your character.
+
+
 ## Database Development
 
 ### SQLite (Recommended for Development)

docs/docs/guides/wsl.md

@@ -0,0 +1,84 @@
+---
+sidebar_position: 5
+title: WSL Setup Guide
+description: Guide for setting up Eliza on Windows using WSL (Windows Subsystem for Linux)
+---
+
+# WSL Setup Guide
+Steps to run Eliza on Windows computer using WSL.
+[AI Dev School Tutorial](https://www.youtube.com/watch?v=ArptLpQiKfI)
+
+
+## Install WSL
+
+1. Open PowerShell as Administrator and run:
+```powershell
+wsl --install
+```
+
+2. Restart your computer
+3. Launch Ubuntu from the Start menu and create your Linux username/password
+
+## Install Dependencies
+
+1. Update Ubuntu packages:
+```bash
+sudo apt update && sudo apt upgrade -y
+```
+
+2. Install system dependencies:
+```bash
+sudo apt install -y \
+    build-essential \
+    python3 \
+    python3-pip \
+    git \
+    curl \
+    ffmpeg \
+    libtool-bin \
+    autoconf \
+    automake \
+    libopus-dev
+```
+
+3. Install Node.js via nvm:
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 23
+nvm use 23
+```
+
+4. Install pnpm:
+```bash
+curl -fsSL https://get.pnpm.io/install.sh | sh -
+source ~/.bashrc
+```
+
+## Optional: CUDA Support
+
+If you have an NVIDIA GPU and want CUDA support:
+
+1. Install CUDA Toolkit on Windows from [NVIDIA's website](https://developer.nvidia.com/cuda-downloads)
+2. WSL will automatically detect and use the Windows CUDA installation
+
+## Clone and Setup Eliza
+
+Follow the [Quickstart Guide](../quickstart.md) starting from the "Installation" section.
+
+## Troubleshooting
+
+- If you encounter `node-gyp` errors, ensure build tools are installed:
+```bash
+sudo apt install -y nodejs-dev node-gyp
+```
+
+- For audio-related issues, verify ffmpeg installation:
+```bash
+ffmpeg -version
+```
+
+- For permission issues, ensure your user owns the project directory:
+```bash
+sudo chown -R $USER:$USER ~/path/to/eliza
+```

docs/docs/quickstart.md

@@ -7,8 +7,6 @@ sidebar_position: 2
 ## Prerequisites
 
 Before getting started with Eliza, ensure you have:
-
-- [Python 2.7+](https://www.python.org/downloads/)
 - [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
 - [pnpm 9+](https://pnpm.io/installation)
 - Git for version control
@@ -125,6 +123,22 @@ You set which model to use inside the character JSON file
    pnpm start --characters="characters/trump.character.json,characters/tate.character.json"
    ```
 
+3. **Interact with the Agent**
+
+   Now you're ready to start a conversation with your agent!
+   Open a new terminal window
+
+   ```bash
+   pnpm start:client
+   ```
+
+   Once the client is running, you'll see a message like this:
+```
+➜  Local:   http://localhost:5173/
+```
+
+   Simply click the link or open your browser to `http://localhost:5173/`. You'll see the chat interface connect to the system, and you can begin interacting with your character.
+
 ## Platform Integration
 
 ### Discord Bot Setup

docs/sidebars.js

@@ -80,6 +80,11 @@ const sidebars = {
           id: "guides/local-development",
           label: "Local Development",
         },
+        {
+            type: "doc",
+            id: "guides/wsl",
+            label: "WSL Setup",
+        },
       ],
     },
     {

package.json

@@ -5,7 +5,7 @@
         "build": "turbo run build --filter=!eliza-docs",
         "build-docker": "turbo run build",
         "start": "pnpm --filter \"@ai16z/agent\" start --isRoot",
-        "start:client": "pnpm --dir client start --isRoot",
+        "start:client": "pnpm --dir client dev",
         "start:debug": "cross-env NODE_ENV=development VERBOSE=true DEBUG=eliza:* pnpm --filter \"@ai16z/agent\" start --isRoot",
         "dev": "bash ./scripts/dev.sh",
         "lint": "bash ./scripts/lint.sh",

packages/core/src/generation.ts

@@ -151,6 +151,7 @@ export async function generateText({
             case ModelProviderName.ALI_BAILIAN:
             case ModelProviderName.VOLENGINE:
             case ModelProviderName.LLAMACLOUD:
+            case ModelProviderName.NANOGPT:
             case ModelProviderName.HYPERBOLIC:
             case ModelProviderName.TOGETHER: {
                 elizaLogger.debug("Initializing OpenAI model.");
@@ -1243,6 +1244,7 @@ export async function handleProvider(
         case ModelProviderName.VOLENGINE:
         case ModelProviderName.LLAMACLOUD:
         case ModelProviderName.TOGETHER:
+        case ModelProviderName.NANOGPT:
             return await handleOpenAI(options);
         case ModelProviderName.ANTHROPIC:
             return await handleAnthropic(options);

packages/core/src/models.ts

@@ -411,6 +411,22 @@ export const models: Models = {
             [ModelClass.EMBEDDING]: "doubao-embedding",
         },
     },
+    [ModelProviderName.NANOGPT]: {
+        endpoint: "https://nano-gpt.com/api/v1",
+        settings: {
+            stop: [],
+            maxInputTokens: 128000,
+            maxOutputTokens: 8192,
+            frequency_penalty: 0.0,
+            presence_penalty: 0.0,
+            temperature: 0.6,
+        },
+        model: {
+            [ModelClass.SMALL]: settings.SMALL_NANOGPT_MODEL || "gpt-4o-mini",
+            [ModelClass.MEDIUM]: settings.MEDIUM_NANOGPT_MODEL || "gpt-4o",
+            [ModelClass.LARGE]: settings.LARGE_NANOGPT_MODEL || "gpt-4o",
+        }
+    },
     [ModelProviderName.HYPERBOLIC]: {
         endpoint: "https://api.hyperbolic.xyz/v1",
         settings: {

packages/core/src/types.ts

@@ -205,6 +205,7 @@ export type Models = {
     [ModelProviderName.GAIANET]: Model;
     [ModelProviderName.ALI_BAILIAN]: Model;
     [ModelProviderName.VOLENGINE]: Model;
+    [ModelProviderName.NANOGPT]: Model;
     [ModelProviderName.HYPERBOLIC]: Model;
 };
 
@@ -231,6 +232,7 @@ export enum ModelProviderName {
     GAIANET = "gaianet",
     ALI_BAILIAN = "ali_bailian",
     VOLENGINE = "volengine",
+    NANOGPT = "nanogpt",
     HYPERBOLIC = "hyperbolic",
 }
 

packages/plugin-flow/src/actions/transfer.ts

@@ -2,7 +2,7 @@ import {
     composeContext,
     Content,
     elizaLogger,
-    generateObjectDEPRECATED,
+    generateObjectArray,
     ModelClass,
     type Action,
     type ActionExample,
@@ -87,12 +87,17 @@ export class TransferAction {
         });
 
         // Generate transfer content
-        const content = await generateObjectDEPRECATED({
+        const recommendations = await generateObjectArray({
             runtime,
             context: transferContext,
-            modelClass: ModelClass.SMALL,
+            modelClass: ModelClass.MEDIUM,
         });
 
+        elizaLogger.debug("Recommendations", recommendations);
+
+        // Convert array to object
+        const content = recommendations[recommendations.length - 1];
+
         // Validate transfer content
         if (!isTransferContent(runtime, content)) {
             elizaLogger.error("Invalid content for SEND_COIN action.");

packages/plugin-flow/src/assets/cadence/transactions/evm/call.cdc

@@ -10,7 +10,20 @@ transaction(evmContractAddressHex: String, calldata: String, gasLimit: UInt64, v
     prepare(signer: auth(BorrowValue) &Account) {
         self.evmAddress = EVM.addressFromString(evmContractAddressHex)
 
-        self.coa = signer.storage.borrow<auth(EVM.Call) &EVM.CadenceOwnedAccount>(from: /storage/evm)
+        let storagePath = StoragePath(identifier: "evm")!
+        let publicPath = PublicPath(identifier: "evm")!
+
+        // Reference signer's COA if one exists
+        let coa = signer.storage.borrow<auth(EVM.Withdraw) &EVM.CadenceOwnedAccount>(from: storagePath)
+        if coa == nil {
+            let coa <- EVM.createCadenceOwnedAccount()
+            signer.storage.save<@EVM.CadenceOwnedAccount>(<-coa, to: storagePath)
+            let addressableCap = signer.capabilities.storage.issue<&EVM.CadenceOwnedAccount>(storagePath)
+            signer.capabilities.unpublish(publicPath)
+            signer.capabilities.publish(addressableCap, at: publicPath)
+        }
+
+        self.coa = signer.storage.borrow<auth(EVM.Call) &EVM.CadenceOwnedAccount>(from: storagePath)
             ?? panic("Could not borrow COA from provided gateway address")
     }
 

packages/plugin-flow/src/providers/connector.provider.ts

@@ -72,7 +72,7 @@ export class FlowConnectorProvider {
     constructor(private readonly instance: FlowConnector) {}
 
     getConnectorStatus(runtime: IAgentRuntime): string {
-        let output = `${runtime.character.name}[${runtime.character.id ?? 0}] Connected to\n`;
+        let output = `Now user<${runtime.character.name}> connected to\n`;
         output += `Flow network: ${this.instance.network}\n`;
         output += `Flow Endpoint: ${this.instance.rpcEndpoint}\n`;
         return output;

packages/plugin-flow/src/providers/wallet.provider.ts

@@ -232,7 +232,12 @@ const flowWalletProvider: Provider = {
                 elizaLogger.error("Invalid account info");
                 return null;
             }
-            return `Flow Wallet Address: ${walletProvider.address}\nBalance: ${info.balance} FLOW\nFlow COA(EVM) Address: ${info.coaAddress || "unknown"}\nFLOW COA(EVM) Balance: ${info.coaBalance ?? 0} FLOW`;
+            let output = `Here is user<${runtime.character.name}>'s wallet status:\n`;
+            output += `Flow wallet address: ${walletProvider.address}\n`;
+            output += `FLOW balance: ${info.balance} FLOW\n`;
+            output += `Flow wallet's COA(EVM) address: ${info.coaAddress || "unknown"}\n`;
+            output += `FLOW balance in COA(EVM) address: ${info.coaBalance ?? 0} FLOW`;
+            return output;
         } catch (error) {
             elizaLogger.error("Error in Flow wallet provider:", error.message);
             return null;