opensouls / souls

Resources for creating AI Souls

🤖+👱 OPEN SOULS (Community)

🤔 What is this?

This repository is a place for sharing knowledge on how to create AI souls. This repository holds docs, snippets, and examples for building AI souls with @opensouls/core and the Soul Engine.

If you have access to the Soul Engine, any soul in the repo can be run from its root directory

cd souls/example-twenty-questions
npx soul-engine dev

💫 AI Souls

AI Souls are agentic and embodied digital beings, one day comprising thousands of mental processes (managed by the Soul Engine). Unlike traditional chatbots, this code will give digital souls personality, drive, ego, and will.

🔑 Getting Soul Engine access

1. Join the OPEN SOULS Discord
2. That's it! Now you can login to the Soul Engine with Discord auth when running npx soul-engine dev

Make sure to checkout the Soul Engine guide!

🙋 Contributing

Check out CONTRIBUTING and open up a PR!

We're excited for contributions, such as:

• Reporting bugs
• Suggesting enhancements
• Submitting new example souls
• Contributing cognitive steps and other code to the library
• Improving documentation
• Providing feedback

📜 License

The documentation (/docs) is included under CC-BY-4.0 license.

Unless otherise noted, the remainder of the repository - i.e. the /library, /demos, and /souls are included under MIT license.

souls's Issues

[BUG] Windows 11: Right side of assignment cannot be destructured

Images

Dev environment

• Windows 11
• Node.js ver 10.4.0
  (add comments if need more specifics)

Process

1. npx soul-engine init samantha
2. cd samantha
3. npx soul-engine dev
4. type anything

MISC

• This error is not shown in Windows 10. (Windows 10 has 500 server error instead, solved when copying .md into /soul dir)

`CONTRIBUTING.md`

Hey there! I was perusing this repo and trying out some of the Souls collected here - nice work by the community!

I would love to add docs or perhaps souls, and have tried to volunteer a minor alteration to be helpful: #68

I also volunteer to author a CONTRIBUTING.md document (with lots of input from the fantastic OpenSouls community and discord) if that would be welcomed!