Credo Canvas

Example Prompts

Pt: 45yo male
CC: Low back pain x2 wks
Onset: Gradual, after lifting boxes
Hx: No trauma, no radiation to legs, no bowel/bladder changes
PMH: HTN, otherwise well
Meds: Amlodipine
Exam: Tender L paraspinal, ↓ flexion, SLR neg, no neuro deficits
Imp: Mechanical LBP
Plan: Reassure, advise activity as tolerated, NSAIDs PRN, physio referral, safety-net re red flags

Pt: 28yo female
CC: Itchy rash on arms x3d
Onset/trigger: After gardening, possible plant contact
Hx: No SOB, no facial swelling, no new meds/foods
PMH: Nil sig
Exam: Erythematous, raised patches forearms, no weeping, no infection signs
Imp: Allergic contact dermatitis
Plan: Topical antihistamine/calamine, oral antihistamine PRN, avoid trigger, f/u if spreading or systemic sx

EMR-style shorthand

34M, flu sx x4d. Fever, cough, myalgia. No SOB/CP. PMH nil. Obs: T38.2, HR88, sats98. Chest clr. Dx: ILI. Plan: fluids, parac/ibu PRN, rest. RTW when afebrile. Safety-net: SOB/CP/persist fever.

45M, LBP x2wks. Gradual onset post lifting. No rad, no red flags. PMH HTN. Exam: L paraspinal TTP, ↓flex, SLR–, neuro NAD. Dx: mech LBP. Plan: reassure, act as tol, NSAID PRN, physio, safety-net.

28F, itchy rash arms x3d. Trigger gardening/plant. No SOB/facial swell. PMH nil. Exam: erythematous raised patches forearms, no infxn. Dx: contact derm (allergic). Plan: topical/oral antihist PRN, avoid trigger, f/u if spread/systemic.

Setup locally

Prerequisites

Open Canvas requires the following API keys and external services:

Package Manager

• Yarn

Authentication

• Supabase account for authentication

LangGraph Server

• LangGraph CLI for running the graph locally

LangSmith

• LangSmith for tracing & observability

Installation

First, clone the repository:

git clone https://github.com/langchain-ai/open-canvas.git
cd open-canvas

Next, install the dependencies:

yarn install

After installing dependencies, copy the contents of both .env.example files in the root of the project, and in apps/web into .env and set the required values:

# The root `.env` file will be read by the LangGraph server for the agents.
cp .env.example .env

# The `apps/web/.env` file will be read by the frontend.
cd apps/web/
cp .env.example .env

Then, setup authentication with Supabase.

Setup Authentication

After creating a Supabase account, visit your dashboard and create a new project.

Next, navigate to the Project Settings page inside your project, and then to the API tag. Copy the Project URL, and anon public project API key. Paste them into the NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY environment variables in the apps/web/.env file.

After this, navigate to the Authentication page, and the Providers tab. Make sure Email is enabled (also ensure you've enabled Confirm Email). You may also enable GitHub, and/or Google if you'd like to use those for authentication. (see these pages for documentation on how to setup each provider: GitHub, Google)

Test authentication

To verify authentication works, run yarn dev and visit localhost:3000. This should redirect you to the login page. From here, you can either login with Google or GitHub, or if you did not configure these providers, navigate to the signup page and create a new account with an email and password. This should then redirect you to a conformation page, and after confirming your email you should be redirected to the home page.

Required Keys:

Updated the following keys:

Base .env file (read by agents and server-side code):

• OPENAI_API_KEY: OpenAI API key (required for OpenAI models)
• EXA_API_KEY: Exa web search API key (required for web search)
• Optional LangSmith/LangChain tracing:
  • LANGCHAIN_TRACING_V2="true"
  • LANGCHAIN_API_KEY=""
  • LANGCHAIN_PROJECT=""

apps/web .env file (read by Next.js frontend/build and API routes):

• NEXT_PUBLIC_SUPABASE_URL: Supabase project URL (required)
• NEXT_PUBLIC_SUPABASE_ANON_KEY: Supabase anon public key (required)
• LANGGRAPH_API_URL: LangGraph server URL used by the frontend (optional; defaults to http://localhost:54367)

Setup LangGraph Server

The first step to running Open Canvas locally is to build the application. This is because Open Canvas uses a monorepo setup, and requires workspace dependencies to be build so other packages/apps can access them.

Now we'll cover how to setup and run the LangGraph server locally.

Navigate to apps/agents and run yarn dev (this runs npx @langchain/langgraph-cli dev --port 54367).

Ready!
- 🚀 API: http://localhost:54367
- 🎨 Studio UI: https://smith.langchain.com/studio?baseUrl=http://localhost:54367

After your LangGraph server is running, execute the following command inside apps/web to start the Open Canvas frontend:

yarn dev

On initial load, compilation may take a little bit of time.

Then, open localhost:3000 and select o4-mini model from the dropdown.

Note: Build is currently not working. You do not need this step to run the project locally. Run the following command from the root of the repository:

yarn build