[{"data":1,"prerenderedAt":356},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-installation":106,"-getting-started-installation-surround":351},[4,26,57,83],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":25},"Getting Started","i-lucide-rocket","/getting-started","1.getting-started",[10,15,20],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","/getting-started/introduction","1.getting-started/1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Installation","/getting-started/installation","1.getting-started/2.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Quick Start","/getting-started/quick-start","1.getting-started/3.quick-start","i-lucide-play",false,{"title":27,"icon":28,"path":29,"stem":30,"children":31,"page":25},"Core Concepts","i-lucide-book-open","/essentials","2.essentials",[32,37,42,47,52],{"title":33,"path":34,"stem":35,"icon":36},"Models","/essentials/models","2.essentials/1.models","i-lucide-box",{"title":38,"path":39,"stem":40,"icon":41},"Collections","/essentials/collections","2.essentials/2.collections","i-lucide-folder",{"title":43,"path":44,"stem":45,"icon":46},"Views","/essentials/views","2.essentials/3.views","i-lucide-table",{"title":48,"path":49,"stem":50,"icon":51},"Schema Evolution","/essentials/schema-evolution","2.essentials/4.schema-evolution","i-lucide-git-branch",{"title":53,"path":54,"stem":55,"icon":56},"Relations","/essentials/relations","2.essentials/5.relations","i-lucide-link",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":25},"Advanced","i-lucide-settings","/advanced","3.advanced",[63,68,73,78],{"title":64,"path":65,"stem":66,"icon":67},"Time-Series","/advanced/time-series","3.advanced/1.time-series","i-lucide-chart-line",{"title":69,"path":70,"stem":71,"icon":72},"Async Support","/advanced/async","3.advanced/2.async","i-lucide-zap",{"title":74,"path":75,"stem":76,"icon":77},"PostgreSQL","/advanced/postgresql","3.advanced/3.postgresql","i-lucide-database",{"title":79,"path":80,"stem":81,"icon":82},"Performance Guide","/advanced/performance","3.advanced/4.performance","i-lucide-gauge",{"title":84,"icon":85,"path":86,"stem":87,"children":88,"page":25},"API Reference","i-lucide-file-code","/api","4.api",[89,94,98,101],{"title":90,"path":91,"stem":92,"icon":93},"Engine","/api/engine","4.api/1.engine","i-lucide-cog",{"title":95,"path":96,"stem":97,"icon":41},"Collection","/api/collection","4.api/2.collection",{"title":33,"path":99,"stem":100,"icon":36},"/api/models","4.api/3.models",{"title":102,"path":103,"stem":104,"icon":105},"Exceptions","/api/exceptions","4.api/4.exceptions","i-lucide-alert-triangle",{"id":107,"title":16,"body":108,"description":344,"extension":345,"links":346,"meta":347,"navigation":348,"path":17,"seo":349,"stem":18,"__hash__":350},"docs/1.getting-started/2.installation.md",{"type":109,"value":110,"toc":336},"minimark",[111,116,142,154,163,167,172,179,200,203,206,224,233,241,245,332],[112,113,115],"h2",{"id":114},"basic-install","Basic install",[117,118,123],"pre",{"className":119,"code":120,"language":121,"meta":122,"style":122},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pip install centaurodb\n","bash","",[124,125,126],"code",{"__ignoreMap":122},[127,128,131,135,139],"span",{"class":129,"line":130},"line",1,[127,132,134],{"class":133},"sBMFI","pip",[127,136,138],{"class":137},"sfazB"," install",[127,140,141],{"class":137}," centaurodb\n",[143,144,145,146,153],"p",{},"This installs CentauroDB with its only runtime dependency: ",[147,148,152],"a",{"href":149,"rel":150},"https://docs.pydantic.dev/",[151],"nofollow","Pydantic"," v2+. SQLite is included in Python's standard library — no extra setup needed.",[155,156,157,158,162],"note",{},"CentauroDB is in beta (v0.9.x) — the SQLite path is ready for real workloads, while PostgreSQL connection pooling is still in the works. Pre-1.0, breaking changes are documented in the ",[147,159,161],{"href":160},"/changelog","changelog",".",[112,164,166],{"id":165},"optional-dependencies","Optional dependencies",[168,169,171],"h3",{"id":170},"polars-time-series-dataframes","Polars (time-series DataFrames)",[143,173,174,175,178],{},"If you want to use the ",[124,176,177],{},".df"," property on time-series models to get Polars DataFrames:",[117,180,182],{"className":119,"code":181,"language":121,"meta":122,"style":122},"pip install \"centaurodb[polars]\"\n",[124,183,184],{"__ignoreMap":122},[127,185,186,188,190,194,197],{"class":129,"line":130},[127,187,134],{"class":133},[127,189,138],{"class":137},[127,191,193],{"class":192},"sMK4o"," \"",[127,195,196],{"class":137},"centaurodb[polars]",[127,198,199],{"class":192},"\"\n",[168,201,74],{"id":202},"postgresql",[143,204,205],{},"If you want to use PostgreSQL as your backend instead of SQLite:",[117,207,209],{"className":119,"code":208,"language":121,"meta":122,"style":122},"pip install \"centaurodb[postgres]\"\n",[124,210,211],{"__ignoreMap":122},[127,212,213,215,217,219,222],{"class":129,"line":130},[127,214,134],{"class":133},[127,216,138],{"class":137},[127,218,193],{"class":192},[127,220,221],{"class":137},"centaurodb[postgres]",[127,223,199],{"class":192},[143,225,226,227,232],{},"This installs ",[147,228,231],{"href":229,"rel":230},"https://www.psycopg.org/",[151],"psycopg"," (the modern PostgreSQL adapter for Python).",[234,235,237,238,162],"callout",{"icon":236},"i-lucide-arrow-right","For connection setup, URL formats, and a comparison with SQLite, see the ",[147,239,240],{"href":75},"PostgreSQL guide",[112,242,244],{"id":243},"verify-the-installation","Verify the installation",[117,246,250],{"className":247,"code":248,"language":249,"meta":122,"style":122},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import centaurodb\nfrom centaurodb import Engine, Collection, CentauroModel\n\nengine = Engine()  # in-memory SQLite\nprint(\"CentauroDB is ready!\")\n","python",[124,251,252,261,286,293,312],{"__ignoreMap":122},[127,253,254,258],{"class":129,"line":130},[127,255,257],{"class":256},"s7zQu","import",[127,259,141],{"class":260},"sTEyZ",[127,262,264,267,270,272,275,278,281,283],{"class":129,"line":263},2,[127,265,266],{"class":256},"from",[127,268,269],{"class":260}," centaurodb ",[127,271,257],{"class":256},[127,273,274],{"class":260}," Engine",[127,276,277],{"class":192},",",[127,279,280],{"class":260}," Collection",[127,282,277],{"class":192},[127,284,285],{"class":260}," CentauroModel\n",[127,287,289],{"class":129,"line":288},3,[127,290,292],{"emptyLinePlaceholder":291},true,"\n",[127,294,296,299,302,305,308],{"class":129,"line":295},4,[127,297,298],{"class":260},"engine ",[127,300,301],{"class":192},"=",[127,303,274],{"class":304},"s2Zo4",[127,306,307],{"class":192},"()",[127,309,311],{"class":310},"sHwdD","  # in-memory SQLite\n",[127,313,315,318,321,324,327,329],{"class":129,"line":314},5,[127,316,317],{"class":304},"print",[127,319,320],{"class":192},"(",[127,322,323],{"class":192},"\"",[127,325,326],{"class":137},"CentauroDB is ready!",[127,328,323],{"class":192},[127,330,331],{"class":192},")\n",[333,334,335],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":122,"searchDepth":263,"depth":263,"links":337},[338,339,343],{"id":114,"depth":263,"text":115},{"id":165,"depth":263,"text":166,"children":340},[341,342],{"id":170,"depth":288,"text":171},{"id":202,"depth":288,"text":74},{"id":243,"depth":263,"text":244},"Install CentauroDB and its optional dependencies.","md",null,{},{"icon":19},{"title":16,"description":344},"-W0P7pzbABokWUeANt5PSBswRSV5yQvoW4vabdN7EIU",[352,354],{"title":11,"path":12,"stem":13,"description":353,"icon":14,"children":-1},"What is CentauroDB and why does it exist.",{"title":21,"path":22,"stem":23,"description":355,"icon":24,"children":-1},"Build a working app with CentauroDB in under 5 minutes — define, store, query, evolve.",1781105061764]