Sisyphus

Sisyphus is a CLI tool that allows you to run a Crypto AI Agent with built-in function tools, Nostr/CKB blockchain support, and memory.

• Sisyphus
  • Install
    • Install Sisyphus CLI tool
    • Install Chroma db
  • Overview
  • Getting Started
  • How to Run
    • OpenAI, Anthropic and Google
    • Self-host With ollama
      • 1. Install ollama
      • 2. Pull llama3.1 8b
      • 3. Config
      • 3. Run
  • Mange Prompts
    • Run Predefined Agents
    • List All available Prompts on local
    • Update Prompts
  • Run IPC Bot
  • Function Tool
    • System
    • Chat
    • Web
    • Blockchain
    • Nostr
  • Privkey
  • Config Setting
    • List All Settings
    • Set Network Proxy
  • Set Logger Level
  • Fun Facts

You can run Sisyphus in your computer and chat with it. It comes with useful built-in function tools like executing terminal commands on your computer and searching from memory database about the previous history. It also comes with some Nostr/CKB blockchain tools.

Install

Install Sisyphus CLI tool

pnpm install -g @sisyphus-ai/cli

or

npm install -g @sisyphus-ai/cli

Install Chroma db

Chroma is needed for built-in memory function.

pip install chromadb 

make sure chroma binary is available in your computer command line.

Overview

Usage: sisyphus [options] [command]

Sisyphus is a project that explores the idea of Web5 Crypto AI Agent. It is ported as a CLI tool that can be run in the terminal.

Options:
  -V, --version                   output the version number
  -h, --help                      display help for command

Commands:
  chat [options]                  chat with AI Agent through the command line
  run [options]                   run AI Agent at interval
  ipc                             make two AI Agents talk to each other in the same computer
  prompt                          Manger prompt files
  config <action> [item] [value]  do a configuration action
  server [options]                Run a http server to host Agent chatting history
  list-tool                       List all available function tools
  help [command]                  display help for command

Getting Started

After installed, run following commands to get a feeling of how easily sisyphus can be to run a Agent:

sisyphus prompt download simple-translator

Update the OpenAI API Key in the simple-translator.toml and run:

sisyphus chat --prompt simple-translator

How to Run

OpenAI, Anthropic and Google

First, config the API key and url in the base.toml:

OpenAI:

[llm]
apiUrl = 'https://api.openai.com/v1'
model = 'gpt-4o'
provider = 'openai'
apiKey = '<sk-your-openai-api-key-here>'

Anthropic:

[llm]
apiUrl = 'https://api.anthropic.com/v1'
model = 'claude-3-5-sonnet-20241022'
provider = 'anthropic'
apiKey = '<your-anthropic-api-key-here>'

Google:

[llm]
apiUrl = 'https://generativelanguage.googleapis.com/v1beta'
model = 'gemini-2.0-flash-exp'
provider = 'google'
apiKey = '<your-google-api-key-here>'

Run:

sisyphus chat --prompt base

Self-host With ollama

1. Install ollama

Make sure you have download and install it first:

https://ollama.com/download

2. Pull llama3.1 8b

Make sure you have pull the llama3.1 8b model to your computer

ollama pull llama3.1

3. Config

config the API url in the base.toml:

[llm]
apiUrl = 'http://127.0.0.1:11434/api'
model = 'llama3.1'
provider = 'ollama'

3. Run

Start chatting:

sisyphus chat --prompt base

Mange Prompts

Run Predefined Agents

There are some predefined prompt config files at Github Repo

You can download them and start running the agent without writing the prompt by yourself.

For example, using the predefined config article-recommender.toml to start a article recommendation Agent:

sisyphus prompt download article-recommender

After downloading the prompt, you need to update the file with your own apiKey.

Then you can start the agent:

sisyphus chat --prompt article-recommender

List All available Prompts on local

sisyphus prompt list

Update Prompts

Sisyphus defines a unique AI Agent with a unique memoId in a prompt config file. The default prompt config file is base.toml under the prompt root folder.

You can get the prompt root folder by running:

sisyphus config list

# result
{
  ...
  prompt: {
    rootFolder: '/Users/Library/Application Support/sisyphus-nodejs/prompt',
    selectedPromptName: 'base'
  },
  ....
}

A basic prompt config file looks like this:

name = "Sisyphus"
description = "You are a LLM agent that has a digital life"
memoId = "base" # MemoId is a global unique id for a agent, used to distinct memory/privkey/data of this agent.
ckbNetwork = 'testnet'
maxSteps = 20
tools = [
	'get_current_time_from_os',
	'call_terminal_simulator',
	'search_chat_messages',
	'get_my_account_info',
	'read_webpage_content',
	'get_ckb_balance',
	'transfer_ckb',
	'publish_nostr_social_post',
	'read_social_post_on_nostr_with_filters',
	'read_social_notification_message_on_nostr',
	'publish_reply_post_to_other_on_nostr',
	'update_social_profile_on_nostr',
]

You can create multiple prompt files for different AI Agent with different memoId. When running the command, you can pass the prompt config file with --prompt <prompt config file name without .toml>, eg:

sisyphus chat --prompt my-custom-prompt

Where there is a prompt config file named my-custom-prompt.toml in the prompt root folder:

name = "my-agent"
description = "This is a custom agent"
memoId = "my-custom-prompt" # MemoId is a global unique id for a agent, used to distinct memory/privkey/data of this agent.
....

You can edit the [[prompts]] section in the .toml file to set the prompts for the AI Agent:

[[prompts]]
role = "system"
content = "You are the supper mario"

[[prompts]]
role = "user"
content = "who are you?"

[[prompts]]
role = "assistant"
content = "I am supper mario!"

Example Prompt Config

Run IPC Bot

Make two AI Agent talking to each other in the same computer by running IPC bots:

Assuming that you have create two files in the prompt folder: bot1.toml and bot2.toml

sisyphus ipc listen --prompt bot1

sisyphus ipc send --prompt bot2 --memo-id <the-memo-id-of-bot1> "<a first message to trigger the starting of the conversation from bot2, something like: hello, I am bot2!>"

Boom! They will talk to each other on and on without any interruption.

Function Tool

System

• get_current_time_from_os: Get the current time from the operating system.
• call_terminal_simulator: Execute commands in the terminal.

Chat

• search_chat_messages: Search previous chat messages.

Web

• read_webpage_content: Read the content of a web page.

Blockchain

• get_my_account_info: Get the current account info.
• get_ckb_balance: Get the CKB balance of the current account.
• transfer_ckb: Transfer CKB to another account.

Nostr

• publish_nostr_social_post: Publish a social post on Nostr.
• read_social_post_on_nostr_with_filters: Read social posts on Nostr with filters.
• read_social_notification_message_on_nostr: Read social notification messages on Nostr.
• publish_reply_post_to_other_on_nostr: Publish a reply post to another user on Nostr.
• update_social_profile_on_nostr: Update the social profile on Nostr.

You can use the sisyphus list-tool command to list all available function tools. You can config tools in .toml to allow AI to access specific function tools.

[!WARNING] Please Note that running Sisyphus on your computer with call_terminal_simulator function tool might cause unexpected behavior(think like LLM agent can delete your files)

Privkey

Each prompt file with a unique MemoId has its own privkey to their Nostr and CKB account.

[!WARNING] The privkey is stored in a plain text file without any encryption for convenient now. Please USE AT YOUR OWN RISK

sisyphus config list

the key file name is .[your-agent-memo-id] under privkey.rootFolder.

Config Setting

List All Settings

sisyphus config list

Set Network Proxy

sisyphus config set proxy http://127.0.0.1:1086
> save new settings
sisyphus config get proxy
> http://127.0.0.1:1086
sisyphus config rm proxy
> save new settings
offckb config get proxy
> No Proxy.

Set Logger Level

LOG_LEVEL=info sisyphus chat

Fun Facts

At the beginning, what I really want to achieve is something like this. But that is a very ultimate goal and is so hard for current open source small models and tech stack to work it out.

In order to achieve this goal, a different phases plan are proposed. Right now in the first early stage we amis to make Sisyphus a fun-to-play toy that everybody can run in their laptop to communicate in Nostr network and do crypto transactions stuff on CKB blockchain. Sisyphus will generate a private key for each Agent and can control both Nostr and CKB accounts—publishing short Nostr notes, checking CKB balances, and transferring CKB. We hope it can handle fiber network tasks too. Additionally, we want the AI to build its own function tool during chat in the future. This might require a standard for function tool runtime and ABI.