Logging LLM Generations, Agent Runs or Conversation Threads
1
Install the Literal AI package
pip install literalai
npm i @literalai/client
2
Instantiate the Literal AI client
import osfrom literalai import LiteralClient# Not compatible with gunicorn's --preload flagliteralai_client = LiteralClient(api_key=os.getenv("LITERAL_API_KEY")) # This is the default and can be omitted
import { LiteralClient } from '@literalai/client';const literalAiClient = new LiteralClient({apiKey: process.env["LITERAL_API_KEY"]}); // This is the default and can be omitted
3
Get your Literal AI API Key
Go to your project page and click on the Settings tab. You will find your API key in the API Key section.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Literal AI Documentation","colors":{"primary":"#F80061","light":"#FFE7EB","dark":"#980039"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/chainlit-5/yVkf8qhp8dsNjo0g/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=yVkf8qhp8dsNjo0g\u0026q=85\u0026s=5041057089add85f6e7b5b730962e5c1","dark":"https://mintcdn.com/chainlit-5/yVkf8qhp8dsNjo0g/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=yVkf8qhp8dsNjo0g\u0026q=85\u0026s=134f341ff227aa290b94b7c53de36a2a"},"navbar":{"links":[],"primary":{"type":"button","label":"Get Started","href":"https://cloud.getliteral.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/chainlit_io","github":"https://github.com/Chainlit","linkedin":"https://www.linkedin.com/company/chainlit"}},"integrations":{"posthog":{"apiKey":"phc_B5OPGyB2PSuzWeqrrOmUIuIl7tQcroYE8jJDc56ES6Q","apiHost":"https://eu.i.posthog.com"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chainlit-5","hasAudioNarration":false,"actualSubdomain":"chainlit-5","customDomains":["docs.literalai.com"],"gitSource":{"type":"github","owner":"chainlit","repo":"literalai-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e6138d1fcd719df030fd","collectionId":"eb832854-76a2-4ae8-97c5-a795a2002454","schemaVersion":"v2"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6a21e6138d1fcd719df030fd:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":36},{"language":"default","tag":"Integrations","count":10},{"language":"default","tag":"Python Client","count":8},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Get Started","count":6},{"language":"default","tag":"TypeScript Client","count":6},{"language":"default","tag":"Evaluation","count":5},{"language":"default","tag":"Application","count":5},{"language":"default","tag":"Settings","count":4},{"language":"default","tag":"More","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"get-started/quick-start","slug":"/get-started/quick-start","pageMetadata":{"title":"Quick Start","description":"Install the Literal AI client and get your API key","icon":"code","href":"/get-started/quick-start"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install the Literal AI client and get your API key\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,CodeGroup,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Instrument your Code`,icon:`code`,color:`#FF0581`,href:`/get-started/quick-start#logging-llm-generations-agent-runs-or-conversation-threads`,children:_jsx(_components.p,{children:`Install the Literal AI SDK and get your API key.`})}),_jsx(Card,{title:`Create your first Prompt from the Playground`,icon:`sparkles`,color:`#2eb88a`,href:`/guides/playground`,children:_jsx(_components.p,{children:`Create, version and A/B test your prompts in the Prompt Playground.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`logging-llm-generations-agent-runs-or-conversation-threads`,children:`Logging LLM Generations, Agent Runs or Conversation Threads`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Install the Literal AI package`,children:_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` literalai`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @literalai/client`})]}),`\n`]})})})]})}),_jsx(Step,{title:`Instantiate the Literal AI client`,children:_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`5`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` literalai `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` LiteralClient`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Not compatible with gunicorn's --preload flag`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`literalai_client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` LiteralClient(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`os.getenv(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"LITERAL_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`#\\xA0This is the default and can be omitted`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`LiteralClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '@literalai/client'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` literalAiClient`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` LiteralClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`apiKey:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"LITERAL_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]}); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// This is the default and can be omitted`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`]})})})]})}),_jsxs(Step,{title:`Get your Literal AI API Key`,children:[_jsxs(_components.p,{children:[`Go to your `,_jsx(_components.a,{href:`https://cloud.getliteral.ai`,children:`project page`}),` and click on the `,_jsx(_components.strong,{children:`Settings`}),` tab. You will find your API key in the `,_jsx(_components.strong,{children:`API Key`}),` section.`]}),_jsx(Frame,{caption:`Copy your API key`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=8a8e0a1bf94d8cd3bf2d61b85069abb2`,alt:`Literal AI API key`,\"data-og-width\":`2858`,width:`2858`,\"data-og-height\":`796`,height:`796`,\"data-path\":`images/api_key.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=280\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=418d3b346cf4c3391398cfd9e307c436 280w, https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=560\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=862ebd4502591ebaeee8e27075ec9bbc 560w, https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=840\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=0e750fd3c5f2c5165068289ddf6cfbbc 840w, https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=1100\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=62755c77eb4063b637372c5f75386436 1100w, https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=1650\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=b21e5d5f6985300004bfd0726570847a 1650w, https://mintcdn.com/chainlit-5/SattO4WPsa_7pLDy/images/api_key.png?w=2500\u0026fit=max\u0026auto=format\u0026n=SattO4WPsa_7pLDy\u0026q=85\u0026s=5ee2033ab962fba8185194532c7d696a 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`start-logging-llm-generations-and-agent-runs`,children:`Start logging LLM generations and agent runs`}),`\n`,_jsx(_components.p,{children:`Literal AI provides`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`low-level SDKs in Python and TypeScript`}),`\n`,_jsx(_components.li,{children:`integrations with LLM providers (OpenAI, etc.) and AI frameworks (LangChain, LlamaIndex, Vercel AI SDK, etc.)`}),`\n`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Logging`,icon:`list-tree`,color:`#2eb88a`,href:`/guides/logs`,children:_jsx(_components.p,{children:`Learn how to instrument your code with the Literal AI SDK.`})}),_jsx(Card,{title:`Integrations`,icon:`gears`,color:`#FF0581`,href:`/integrations`,children:_jsx(_components.p,{children:`Browse the list of integrations available with Literal AI.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Quick Start","description":"Install the Literal AI client and get your API key","icon":"code","href":"/get-started/quick-start"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Logging LLM Generations, Agent Runs or Conversation Threads","slug":"logging-llm-generations-agent-runs-or-conversation-threads","depth":2,"children":[]},{"title":"Start logging LLM generations and agent runs","slug":"start-logging-llm-generations-and-agent-runs","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chainlit-5","siteName":"Literal AI Documentation","title":"Quick Start - Literal AI Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:43:25.585Z","originalFileLocation":"get-started/quick-start.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install the Literal AI client and get your API key\">\u003cmeta data-mint-head name=\"application-name\" content=\"Literal AI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Quick Start - Literal AI Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install the Literal AI client and get your API key\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Literal AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.literalai.com/get-started/quick-start\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chainlit-5.mintlify.app/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Quick+Start\u0026amp;description=Install+the+Literal+AI+client+and+get+your+API+key\u0026amp;theme=b323e8675abdfeefc1155f40\u0026amp;signature=5e9babb383c1d3aadcd55efa9aaa60b3d64b107a2d128e59f2968124f8f0ea2d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Quick Start - Literal AI Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install the Literal AI client and get your API key\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chainlit-5.mintlify.app/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Quick+Start\u0026amp;description=Install+the+Literal+AI+client+and+get+your+API+key\u0026amp;theme=b323e8675abdfeefc1155f40\u0026amp;signature=5e9babb383c1d3aadcd55efa9aaa60b3d64b107a2d128e59f2968124f8f0ea2d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/chainlit-5/ME3zdq2jEWAz0RSr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Literal AI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F80061\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.literalai.com/get-started/quick-start\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/get-started/quick-start.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.literalai.com/#organization\",\"name\":\"Literal AI Documentation\",\"url\":\"https://docs.literalai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chainlit-5/yVkf8qhp8dsNjo0g/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=yVkf8qhp8dsNjo0g\u0026q=85\u0026s=5041057089add85f6e7b5b730962e5c1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.literalai.com#website\",\"name\":\"Literal AI Documentation\",\"url\":\"https://docs.literalai.com\",\"publisher\":{\"@id\":\"https://docs.literalai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.literalai.com/get-started/quick-start#webpage\",\"url\":\"https://docs.literalai.com/get-started/quick-start\",\"name\":\"Quick Start\",\"description\":\"Install the Literal AI client and get your API key\",\"dateModified\":\"2026-01-07T00:43:25.585Z\",\"isPartOf\":{\"@id\":\"https://docs.literalai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.literalai.com/get-started/quick-start#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.literalai.com/get-started/quick-start#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://docs.literalai.com/get-started/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Quick Start\",\"item\":\"https://docs.literalai.com/get-started/quick-start\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.literalai.com/get-started/quick-start#article\",\"headline\":\"Quick Start\",\"name\":\"Quick Start\",\"description\":\"Install the Literal AI client and get your API key\",\"url\":\"https://docs.literalai.com/get-started/quick-start\",\"mainEntityOfPage\":{\"@id\":\"https://docs.literalai.com/get-started/quick-start#webpage\"},\"dateModified\":\"2026-01-07T00:43:25.585Z\",\"publisher\":{\"@id\":\"https://docs.literalai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.literalai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Literal AI Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Literal AI Documentation","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Important Notice","pages":[{"title":"Migration Guide","icon":"arrow-right-arrow-left","href":"/more/migration-guide"}]},{"group":"Get Started","pages":[{"title":"Overview","description":"Literal AI is the collaborative platform for building **production-grade LLM apps**.","icon":"rocket","href":"/get-started/overview"},{"title":"Quick Start","icon":"code","href":"/get-started/quick-start"}]},{"group":"Application","pages":[{"title":"Dashboard","description":"Monitor your AI application usage, and track performance and reliability.","icon":"chart-line","href":"/guides/dashboard"},{"title":"Logs","icon":"list-tree","href":"/guides/logs"},{"title":"Prompts","icon":"message-code","href":"/guides/prompts"},{"title":"Playground","icon":"terminal","href":"/guides/playground"},{"title":"Users","icon":"users","href":"/guides/users"}]},{"group":"Evaluation","pages":[{"title":"Scorers","icon":"ruler","href":"/guides/scorers"},{"title":"Online Evals","icon":"wave-pulse","href":"/guides/online-evals"},{"title":"Datasets","icon":"database","href":"/guides/dataset"},{"title":"Experiments","icon":"flask","href":"/guides/experiment"},{"title":"Annotation Queues","icon":"pen-circle","href":"/guides/annotation-queue"}]},{"group":"Settings","pages":[{"title":"General","icon":"globe","href":"/guides/settings/general"},{"title":"LLM","icon":"key-skeleton","href":"/guides/settings/llm"},{"title":"Scoring","icon":"list","href":"/guides/settings/scoring"},{"title":"Team","icon":"users","href":"/guides/settings/team"}]},{"group":"Guides","pages":[{"title":"Evaluation","icon":"sparkles","href":"/guides/evaluation"},{"title":"Continuous Improvement","icon":"repeat","href":"/guides/continuous-improvement"},{"title":"Fine-tuning","icon":"wrench","href":"/guides/distillation"}]},{"group":"Integrations","pages":[{"title":"OpenAI","icon":"check","href":"/integrations/openai"},{"title":"LangChain/LangGraph","icon":"check","href":"/integrations/langchain"},{"title":"Llama Index","icon":"check","href":"/integrations/llama-index"},{"title":"LiteLLM","icon":"check","href":"/integrations/litellm"},{"title":"Other LLM Providers (Anthropic, etc.)","icon":"check","href":"/integrations/llm-providers"},{"title":"LLM Inference servers (vLLM, etc.)","icon":"check","href":"/integrations/messages-server"},{"title":"Mistral AI","icon":"check","href":"/integrations/mistralai"},{"title":"Vercel AI SDK","icon":"check","href":"/integrations/vercel-ai-sdk"},{"title":"OpenLLMetry","icon":"check","href":"/integrations/openllmetry"},{"title":"Chainlit","icon":"check","href":"/integrations/chainlit"}]},{"group":"Self Hosting","pages":[{"title":"Get Started","icon":"rocket","href":"/self-hosting/get-started"},{"title":"Manual Deployment","icon":"docker","href":"/self-hosting/deployment"}]},{"group":"More","pages":[{"title":"Privacy \u0026 Security","icon":"shield","href":"/more/security"},{"title":"Export Data","icon":"download","href":"/more/export-data"},{"title":"Release Notes","icon":"notes","href":"/more/release-notes"},{"title":"Roadmap","icon":"road","href":"/more/roadmap"}]}]},{"anchor":"Python Client","icon":"python","pages":[{"title":"Python Client","href":"/python-client/get-started/introduction"}]},{"anchor":"TypeScript Client","icon":"js","pages":[{"title":"TypeScript Client","href":"/typescript-client/introduction"}]},{"anchor":"Cookbooks","href":"https://github.com/Chainlit/literalai-cookbooks","icon":"github"}]},"title":"Quick Start - Literal AI Documentation","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-COGkNuA6.js","DynamicMarkdown-85clUA0i.js","zoom-image-lightbox-BZxD9MAj.js","lightbox-handle-r17bVUz3.js"]}