What do you want to do?
5 use cases
-
Run a persona bot locally and chat with it in the WebUI
Start Cortico on your machine and talk to the reference bot in a browser console.
- Cortico
- Software and DevOps
- Intermediate
View prompt
In the Cortico repo at <path>, install dependencies and start the default deployment, then configure a model endpoint from the WebUI at http://127.0.0.1:7788/. Report the deployment name and confirm the bot sends a reply after Say hello.
-
Build a Cortico extension by talking to a coding agent
Use the Cortina workspace and any coding agent to create or port a World extension.
- Cortico
- Software and DevOps
- Intermediate
View prompt
Open the Cortina workspace cloned from https://github.com/Pal-AI-Lab/Cortina and build a Cortico World extension that <goal>. Expected output: a package folder with a finished extension and npm publish steps. Verify that package.json includes the cortico-world keyword before publishing.
-
Run an AI VTuber with a Live2D model, streaming TTS and OBS overlay
Use the cortico-world-vtuber project to drive a Live2D avatar, speech and subtitles.
- Cortico
- Software and DevOps
- Advanced
View prompt
Clone https://github.com/Pal-AI-Lab/cortico-world-vtuber and set it up as a Cortico World for a Live2D model in VTube Studio. Expected output: a running World that shows subtitles in the OBS overlay. Verify that the subtitle timing lines up with the spoken audio.
-
Run a bot that reacts to Bilibili live room events
Connect the Bilibili World to answer danmaku, superchats, gifts and guards in a live room.
- Cortico
- Software and DevOps
- Intermediate
View prompt
In the Cortico repo at <path>, enable the bilibili World for the default deployment and confirm that a test danmaku event reaches the bot. Expected output: a logged event and a bot reply. Verify that credentials are stored only in local configuration and not in committed files.
-
Run several bot personas from separate deployments
Create isolated deployment folders so each persona has its own config and memory.
- Cortico
- Software and DevOps
- Intermediate
View prompt
In the Cortico repo at <path>, create a new deployment with `pnpm start --new` and then start it by name. Expected output: a second deployment directory under deployments/ that starts separately. Verify that the first deployment is unchanged after the second one is configured.
How to use Cortico
- Check you have what it needs: Node 22+; A model endpoint that supports the Responses protocol, or a local llama-server runtime; git, to clone the Cortina workspace for extension work.
- Open Pal-AI-Lab/Cortico on GitHub and read the README and license.
- Run
corepack pnpm installin the cloned Cortico folder. - Run
pnpm start. - Open http://127.0.0.1:7788/ in your browser.
- Follow the three onboarding steps: configure a model endpoint, inspect active Worlds, and adjust the system prompt.
These steps come from our top use case, Run a persona bot locally and chat with it in the WebUI, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeCortico alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers and makers who want to run persona bots, AI streamers or roleplay companions, and non-developers who want an AI agent to build Cortico extensions.
- Why it is hot
- LanguageTypeScript
- Sourcegithub.com/Pal-AI-Lab/Cortico · Back to Hot repos
Requirements
- Node 22+
- A model endpoint that supports the Responses protocol, or a local llama-server runtime
- git, to clone the Cortina workspace for extension work
- A coding agent, for the Cortina extension workflow
Maintain Cortico? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/pal-ai-lab-cortico/?ref=badge)
Questions about Cortico
What is Cortico?
Cortico is a free, open source TypeScript agent harness for building persistent, always-running AI bots that handle mixed real-time input from chat platforms, live games and other environments. It is an open-source project on GitHub: https://github.com/Pal-AI-Lab/Cortico.
Who is Cortico for?
Developers and makers who want to run persona bots, AI streamers or roleplay companions, and non-developers who want an AI agent to build Cortico extensions.
What can I do with Cortico?
5 use cases so far, for example: Run a persona bot locally and chat with it in the WebUI; Build a Cortico extension by talking to a coding agent; Run an AI VTuber with a Live2D model, streaming TTS and OBS overlay. Each has steps and a copy-paste agent prompt.
What do I need to run Cortico?
Node 22+; A model endpoint that supports the Responses protocol, or a local llama-server runtime; git, to clone the Cortina workspace for extension work; A coding agent, for the Cortina extension workflow.
What are alternatives to Cortico?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Cortico safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.