{"id":7456,"date":"2026-08-19T19:10:05","date_gmt":"2026-08-19T19:10:05","guid":{"rendered":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/"},"modified":"2026-08-19T19:10:05","modified_gmt":"2026-08-19T19:10:05","slug":"principes","status":"publish","type":"wvn_doc","link":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/presentation\/principes\/","title":{"rendered":"Design principles"},"content":{"rendered":"<h1>Design principles<\/h1>\n<p>Five biases explain most of WivenLLM&#039;s choices. Understanding them helps.<br \/>\nto understand why the application behaves the way it does.<\/p>\n<hr \/>\n<h2>1. Local by default, cloud by choice<\/h2>\n<p>No API key is required during installation. WivenLLM starts with:<\/p>\n<ul>\n<li>A <strong>integrated embeddings engine<\/strong> which runs on the machine; ;<\/li>\n<li>a <strong>local vector base<\/strong> stored in a folder within the installation; ;<\/li>\n<li>a <strong>local database<\/strong> for spaces, conversations and settings.<\/li>\n<\/ul>\n<p>The language model is the only element to choose, and it too can be<br \/>\nlocal. An installation can therefore operate <strong>without any outgoing connection<\/strong>.<\/p>\n<p>Connecting to a cloud provider remains possible, and sometimes it&#039;s the right choice \u2014 for<br \/>\nquality, speed, or a one-off need. But it&#039;s a <strong>decision<br \/>\nexplicit<\/strong>, taken by an administrator, not a default state.<\/p>\n<p><strong>Practical consequence:<\/strong> the screen <code>Settings \u2192 Privacy<\/code> summarizes everything<br \/>\nat what point which components are local and which are outside the scope.<\/p>\n<hr \/>\n<h2>2. No component is mandatory<\/h2>\n<p>The language model, the embeddings engine, and the vector database are three<br \/>\nInterchangeable building blocks. WivenLLM communicates with each one through an interface<br \/>\nCommon: adding a supplier does not change anything else in the application.<\/p>\n<p>This is what allows us to:<\/p>\n<ul>\n<li>start locally, then move to a more powerful model without reindexing your<br \/>\n  spaces (as long as the embeddings engine does not change); ;<\/li>\n<li>use a different template for each workspace \u2014 a quick template for the<br \/>\n  common questions, a heavier model for analysis; ;<\/li>\n<li>replace the local vector database with an enterprise database on the day when the<br \/>\n  The volume justifies it.<\/li>\n<\/ul>\n<p>\u2192 <a href=\"\/en\/wiven-llm\/docs\/reference\/fournisseurs\/\">Supported providers<\/a><\/p>\n<hr \/>\n<h2>3. An answer must be verifiable<\/h2>\n<p>Each answer built from your documents displays the <strong>excerpts<br \/>\nsources<\/strong> which were used to produce it: name of the document and exact passage.<\/p>\n<p>This principle is also found elsewhere:<\/p>\n<ul>\n<li>THE <strong>event log<\/strong> retains the structuring actions of the instance; ;<\/li>\n<li>The conversation history can be viewed and exported by a<br \/>\n  administrator; ;<\/li>\n<li>When an agent uses a tool, the conversation shows it.<\/li>\n<\/ul>\n<p>The goal is not to make the model infallible, but to make its work<br \/>\n<strong>inspectable<\/strong>.<\/p>\n<hr \/>\n<h2>4. Control is the administrator&#039;s responsibility, not the user&#039;s.<\/h2>\n<p>Decisions that commit the organization \u2014 which supplier, which skills<br \/>\nagent, what content rules, who accesses what \u2014 are grouped in<br \/>\nadministration and invisible to users.<\/p>\n<p>These have a deliberately simple interface: workspaces,<br \/>\nConversations, documents. They can settle what concerns them.<br \/>\n(appearance, language, their own memories) without being able to change the<br \/>\ninstance configuration.<\/p>\n<p>\u2192 <a href=\"\/en\/wiven-llm\/docs\/administration\/utilisateurs\/\">Users and roles<\/a><\/p>\n<hr \/>\n<h2>5. We start small<\/h2>\n<p>The application is usable from onboarding, with a workspace and a<br \/>\ndocument. Advanced functions \u2014 agents, flows, scheduled tasks, router<br \/>\nTemplates, web widgets, APIs \u2014 are disabled or empty by default and are enabled<br \/>\nwhen the need arises.<\/p>\n<p>This principle explains why certain functions are invisible as long as they<br \/>\nhave not been activated: <code>Settings \u2192 Beta features<\/code>, <code>Settings \u2192 Agents<\/code>,<br \/>\n<code>Settings \u2192 Scheduled Tasks<\/code>.<\/p>\n<hr \/>\n<h2>What these principles mean for you<\/h2>\n<table>\n<thead>\n<tr>\n<th>If you want\u2026<\/th>\n<th>The product directs you to\u2026<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Don&#039;t let anything out<\/td>\n<td>Local native model + local vector base + native embeddings<\/td>\n<\/tr>\n<tr>\n<td>The best possible response quality<\/td>\n<td>An external supplier, chosen and explicitly documented<\/td>\n<\/tr>\n<tr>\n<td>Both, depending on the case<\/td>\n<td>One model per workspace, or a <a href=\"\/en\/wiven-llm\/docs\/administration\/routeur\/\">router models<\/a><\/td>\n<\/tr>\n<tr>\n<td>Prove what happened<\/td>\n<td>Citations from sources + <a href=\"\/en\/wiven-llm\/docs\/administration\/journaux\/\">event log<\/a><\/td>\n<\/tr>\n<tr>\n<td>Regulating practices<\/td>\n<td><a href=\"\/en\/wiven-llm\/docs\/administration\/utilisateurs\/\">Roles<\/a> + <a href=\"\/en\/wiven-llm\/docs\/administration\/controle-de-contenu\/\">content control<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>","protected":false},"parent":7454,"menu_order":102,"template":"","meta":[],"class_list":["post-7456","wvn_doc","type-wvn_doc","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Principes de conception \u2014 Documentation WivenLLM<\/title>\n<meta name=\"description\" content=\"Les cinq partis pris qui expliquent le fonctionnement de WivenLLM \u2014 localit\u00e9 par d\u00e9faut, portabilit\u00e9, visibilit\u00e9, gouvernance et progressivit\u00e9.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/presentation\/principes\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Principes de conception \u2014 Documentation WivenLLM\" \/>\n<meta property=\"og:description\" content=\"Les cinq partis pris qui expliquent le fonctionnement de WivenLLM \u2014 localit\u00e9 par d\u00e9faut, portabilit\u00e9, visibilit\u00e9, gouvernance et progressivit\u00e9.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/presentation\/principes\/\" \/>\n<meta property=\"og:site_name\" content=\"Wiven AI\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/principes\\\/\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/principes\\\/\",\"name\":\"Principes de conception \u2014 Documentation WivenLLM\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\"},\"datePublished\":\"2026-08-19T19:10:05+00:00\",\"description\":\"Les cinq partis pris qui expliquent le fonctionnement de WivenLLM \u2014 localit\u00e9 par d\u00e9faut, portabilit\u00e9, visibilit\u00e9, gouvernance et progressivit\u00e9.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/principes\\\/#breadcrumb\"},\"inLanguage\":\"en\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/principes\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/principes\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Qu&rsquo;est-ce que WivenLLM\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/presentation\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Principes de conception\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/\",\"name\":\"Wiven AI\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.wiven.ai\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Design Principles \u2014 WivenLLM Documentation","description":"The five biases that explain how WivenLLM works \u2014 default locality, portability, visibility, governance and progressiveness.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/presentation\/principes\/","og_locale":"en_US","og_type":"article","og_title":"Principes de conception \u2014 Documentation WivenLLM","og_description":"Les cinq partis pris qui expliquent le fonctionnement de WivenLLM \u2014 localit\u00e9 par d\u00e9faut, portabilit\u00e9, visibilit\u00e9, gouvernance et progressivit\u00e9.","og_url":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/presentation\/principes\/","og_site_name":"Wiven AI","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/","url":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/","name":"Design Principles \u2014 WivenLLM Documentation","isPartOf":{"@id":"https:\/\/www.wiven.ai\/#website"},"datePublished":"2026-08-19T19:10:05+00:00","description":"The five biases that explain how WivenLLM works \u2014 default locality, portability, visibility, governance and progressiveness.","breadcrumb":{"@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/#breadcrumb"},"inLanguage":"en","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/principes\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wiven.ai\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/"},{"@type":"ListItem","position":3,"name":"Qu&rsquo;est-ce que WivenLLM","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/presentation\/"},{"@type":"ListItem","position":4,"name":"Principes de conception"}]},{"@type":"WebSite","@id":"https:\/\/www.wiven.ai\/#website","url":"https:\/\/www.wiven.ai\/","name":"Wiven AI","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wiven.ai\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en"}]}},"_links":{"self":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7456","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc"}],"about":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/types\/wvn_doc"}],"up":[{"embeddable":true,"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7454"}],"wp:attachment":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/media?parent=7456"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}