YouSim

YouSim is a simulator that lets you simulate identities within the latent space of Claude 3.5 Sonnet. It's live at https://yousim.ai!

Environment Variables

These are different values you set in a .env file that affect the behavior of YouSim. Some of them are related to the web deployment for things like user accounts and shareable links, while other's impact the core behavior of YouSim.

There is an .env.template file that covers all of these. Some special callouts and notes.

There is a PROVIDER variable that controls which LLM provider is used by YouSim. Currently, this only supports

• anthropic
• openrouter

If you specify anthropic It will use claude-sonnet-3.5 as the model and make use of the new caching feature. This also means you needs to specify a ANTHROPIC_API_KEY in your .env.

If you specify openrouter you then need to provide an additional variable called OPENROUTER_MODEL to specify which model you want to use. This also means you need to specify an OPENAI_API_KEY in your .env which corresponds to your OPENROUTER API Key.

Self-Hosting

If you don't want to run the entire web deployment of YouSim you can run the main conversation loop experience all from the terminal by running the main.py file. This won't save conversations, let you share, or link them to any account, but it's a quick way to get started.

Run the following commands to run the terminal experience:

poetry install
poetry run python main.py

Make sure you have the appropriate API keys specified in your .env

Web Experience

You can run Yousim locally with Docker Compose. To get started, configure your .env files: .env for the backend and webshell/.env for the frontend.

For the backend, copy the .env.template file to .env and fill out the variables:

cp .env.template .env

ANTHROPIC_API_KEY: Anthropic API key
HONCHO_ENV: Default value in .env.template goes to the Honcho demo server. You'd only change this if you were running Honcho locally
HONCHO_APP_NAME: This denotes your application on the Honcho demo server
CLIENT_REGEX: Use default value in .env.template
JWT_SECRET: This comes from your supabase project (more on that below)
SECRET_KEY: Generate this with python generate_fernet_key.py -- makes links shareable without revealing information

For the frontend, copy the .env.template file to .env and fill out the variables:

cp webshell/.env.template webshell/.env

VITE_API_URL: This should be the url of your backend
VITE_SUPABASE_URL: This comes from your supabase project
VITE_SUPABASE_KEY: This comes from your supabase project (public key!)

Docker

We've included a Dockerfiles and a docker-compose.yml for convenience when running the YouSim locally.

There are some special consideration to make.

1. For the webshell front end the .env variables are used during build time, so ensure they are set correctly before building your docker images.
2. The webshell front end runs on port 3000 when running via docker so change your Python API .env CLIENT_REGEX to localhost:3000 to match.

You can run both the backend and the frontend with:

docker-compose up

Supabase

This project uses Supabase for account management and authentication. We made use of the magic link and anonymous account sign features. To run this with your own supabase project ensure you take the following steps.

1. Turn on anonymous sign ins

https://supabase.com/docs/guides/auth/auth-anonymous

2. Change the magic link email template to include the OTP Code

In your Supabase project go to Authentication > Email Templates and select the Magic Link template. Below is an example of a template you can use:

<h2>YouSim Login Code</h2>

<p>Use this code to login:</p>
<p>{{ .Token }}</p>

Credits

Thanks to nasan16 for their initial work on webshell and Andy Ayrey for his work on Infinite Backrooms, whose prompts heavily inspired this project.