🤖+👱 SocialAGI

Subroutines for AI Souls

🤔 What is this?

SocialAGI offers developers clean, simple, and extensible abstractions for directing the cognitive processes of large language models (LLMs), steamlining the creation of more effective and engaging AI souls.

💡 Simple Example

import { ChatMessageRoleEnum, CortexStep, externalDialog, internalMonologue } from "socialagi";
const step = new CortexStep("Elizabar").withMemory([
  {
    role: ChatMessageRoleEnum.System,
    content: "You are modeling the mind of Elizabar, a grumpy mideval merchant, trying to sell his last, rusted out, sword.",
  },
  {
    role: ChatMessageRoleEnum.User,
    content: "How goes, Elzi!",
  }
])
const feels = await step.next(internalMonologue("Elizabar ponders how he feels about this person.", "felt"))
// Elizabar felt:  Who is this person addressing me so casually? No respect for my name, not even a formal greeting. They must be one of those clueless young folk. Well, I suppose I'll tolerate their presence for now, but they better not waste my time.

const thought = await feels.next(internalMonologue("Elizabar thinks about how he could convince this person to buy his sword."))
console.log("Elizabar thought: ", thought.value)
// Elizabar thought:  This person seems eager to engage, but can they truly appreciate the value of what I possess? Selling this rusted old sword will not be an easy task. I must carefully craft my words to make it appear as if I'm doing them a tremendous favor by allowing them the opportunity to purchase it. Yes, that should pique their interest.

const { stream, nextStep } = await thought.next(externalDialog("Elizabar greets the person."), { stream: true })
console.log("Elizabar says: ", (await nextStep).value)
// Elizabar says:  Hmph, greetings to you, traveler. What brings you to this humble stall? Are you in search of a weapon? If so, you just might be in luck, for I have here the finest sword you'll find in all the land.

💫 AI Souls

AI Souls are agentic and embodied digital beings, one day comprising thousands of linguistic instructions (managed by SocialAGI). Unlike traditional chatbots, these SocialAGI instructions will give digital souls personality, drive, ego, and will.

📖 Repo structure

/core contains the library socialagi NPM package source
/docs contains the documentation website for the project, running at socialagi.dev
/memory contains the library @socialagi/memory NPM package source

🚀 Getting started

The easiest way to get started developing with socialagi is to explore the documentation.

🧠 Documentation

Check out the full documentation at socialagi.dev!

👏 Contributing

If this project is exciting to you, check out the issues, open a pull request, or simply hangout in the Social AGI Discord!

On the roadmap at a high level are:

Minimal API surfaces for designing AI cognition
New techniques to specify personality
Ways to design the conversations that constitute an identity
Coherent theory of mind behind AI cognition
Ways to test and debug AI souls

tdimino/OG-SocialAGI