Luna 🤖

📖 Documentation | 🎯 Examples

✨ Features

• 🛠️ Full-featured Discord, Twitter and Telegram connectors
• 👥 Multi-agent and room support
• 📚 Easily ingest and interact with your documents
• 💾 Retrievable memory and document store
• 🚀 Highly extensible - create your own actions and clients
• 📦 Just works!

Video Tutorials

AI Agent Dev School

🎯 Use Cases

• 🤖 Chatbots
• 🕵️ Autonomous Agents
• 📈 Business Process Handling
• 🎮 Video Game NPCs
• 🧠 Trading

🚀 Quick Start

Prerequisites

• Python 2.7+
• Node.js 23+
• pnpm

Note for Windows Users: WSL 2 is required.

Use the Starter (Recommended)

git clone https://github.com/lunaos/luna-starter.git
cd luna-starter
cp .env.example .env
pnpm i && pnpm build && pnpm start

Then read the Documentation to learn how to customize your luna.

Manually Start Luna (Only recommended if you know what you are doing)

# Clone the repository
git clone https://github.com/lunaos/luna.git

# Checkout the latest release
# This project iterates fast, so we recommend checking out the latest release
git checkout $(git describe --tags --abbrev=0)

Edit the .env file

Copy .env.example to .env and fill in the appropriate values.

cp .env.example .env

Note: .env is optional. If your planning to run multiple distinct agents, you can pass secrets through the character JSON

Automatically Start Luna

This will run everything to setup the project and start the bot with the default character.

sh scripts/start.sh

Edit the character file

1. Open packages/core/src/defaultCharacter.ts to modify the default character. Uncomment and edit.

2. To load custom characters:

   • Use pnpm start --characters="path/to/your/character.json"
   • Multiple character files can be loaded simultaneously

3. Connect with X (Twitter)

   • change "clients": [] to "clients": ["twitter"] in the character file to connect with X

Manually Start Luna

pnpm i
pnpm build
pnpm start

# The project iterates fast, sometimes you need to clean the project if you are coming back to the project
pnpm clean

Additional Requirements

You may need to install Sharp. If you see an error when starting up, try installing it with the following command:

pnpm install --include=optional sharp