wip: plotly & additional documentation

templates/documentation/get_started.html

@@ -0,0 +1,56 @@
+{% extends 'documentation/base.html' %}
+{% block article %}
+<h2>Get Started with Minne</h2>
+<p>Minne offers two installation options to suit your needs:</p>
+<ol>
+  <li>
+    <strong>Hosted Version:</strong> Enjoy a hassle‐free experience by signing up for the ready‐to‐use service.
+    Simply navigate to <code>/signup</code> to create an account.
+  </li>
+  <li>
+    <strong>Self-Hosted:</strong> Gain full control by running Minne on your own infrastructure. Visit
+    <a href="https://github.com/perstarkse/minne">GitHub</a> to download the latest release. After extracting the
+    release, open the <code>config.yaml</code> file and set the following configurations:
+  </li>
+</ol>
+<pre><code>OPENAI_API_KEY: your_api_key
+    SMTP_EMAIL_RELAYER: your_email_relayer
+    SMTP_USERNAME: your_smtp_username
+    SMTP_PASSWORD: your_smtp_password
+    DB_ADDRESS: your_db_address
+    DB_USER: your_db_user
+    DB_PASSWORD: your_db_password</code></pre>
+<p>The database settings relate to a running instance of SurrealDB. You can opt for their cloud solution or run your
+  own instance.</p>
+
+<p>Once your configuration is complete, start both the server and the worker. They can be hosted on separate
+  machines, with different resource requirements:</p>
+<ul>
+  <li>
+    <strong>Server:</strong> Lightweight, using roughly 50MB of RAM. A minimum of 1 core and 256MB of RAM is
+    recommended.
+  </li>
+  <li>
+    <strong>Worker:</strong> Handles content parsing, typically consuming about 60MB of RAM—occasionally peaking up
+    to 1GB. We recommend allocating at least 2 cores and 1024MB of RAM.
+  </li>
+</ul>
+
+<p>After launching the services, navigate to <code>&lt;your_url&gt;:3000/signup</code> to register. The first
+  account created will automatically receive admin permissions, allowing you to later disable further registrations
+  via the <code>/admin</code> page if desired.</p>
+
+<p>From the homepage (<code>/</code>), you can:</p>
+<ul>
+  <li>Submit content, including files, videos, and URLs for ingestion.</li>
+  <li>Monitor job statuses and manage your existing content.</li>
+  <li>Search your content or start a chat conversation for assistance.</li>
+</ul>
+
+<p>Visit the <code>/knowledge</code> page to view your content organized by different sections. This page also
+  provides a visual demonstration of the graph database structure, enhancing your understanding of content
+  relationships.</p>
+
+<p>This streamlined setup ensures intuitive onboarding while offering robust customization options. Whether you are
+  a novice or an advanced user, Minne is designed to deliver a smooth experience and reliable performance.</p>
+{% endblock %}

templates/documentation/menu.html

@@ -1,6 +1,11 @@
-<ul class="menu bg-base-200 rounded-box w-full">
-  <li><a hx-boost="true" href="/documentation">Start</a></li>
-  <li><a hx-boost="true" class="" href="/documentation/privacy-policy">Privacy Policy</a></li>
+<ul class="menu bg-base-200 rounded-box w-full ">
+  <li><a hx-boost="true" class="{{'menu-active' if current_path=='/index' }}" href="/documentation">Start</a></li>
+  <li><a hx-boost="true" class="{{'menu-active' if current_path=='/get-started' }}"
+      href="/documentation/get-started">Get Started</a></li>
+  <li><a hx-boost="true" class="{{'menu-active' if current_path=='/mobile-friendly' }}"
+      href="/documentation/mobile-friendly">Mobile friendly</a></li>
+  <li><a hx-boost="true" class="{{'menu-active' if current_path=='/privacy-policy' }}"
+      href="/documentation/privacy-policy">Privacy Policy</a></li>
   <li>
     <details open>
       <summary>Core Concepts</summary>

templates/documentation/mobile_friendly.html

@@ -0,0 +1,22 @@
+{% extends 'documentation/base.html' %}
+{% block article %}
+<header>
+  <h2>Mobile Friendly Ingression: How to Submit Content from iOS to Minne</h2>
+</header>
+<p>Minne is built with simplicity in mind. Whether you wish to save a file, capture a thought, or share a page,
+  submitting content is effortless. Our server provides API access that enables users to perform actions using a
+  personalized API key.</p>
+
+<p>An iOS shortcut has been developed to streamline the process of sending content. To begin, navigate to
+  <code>/account</code> and generate an API key. Once created, you will see an option to download the iOS shortcut.
+</p>
+
+<p>After downloading the shortcut, update the "Get response from URL" authentication headers with your API key. If
+  you are self-hosting, ensure the URL is adjusted accordingly.</p>
+
+<p>The shortcut integrates seamlessly with iOS. When you "share with Minne," you will be prompted to provide
+  instructions to the AI and to either choose an existing category or create a new one for your submission.</p>
+
+<p>While an Android solution is in the works, for now you can add the web app to your home screen as a Progressive
+  Web App (PWA) for a similar mobile-friendly experience.</p>
+{% endblock %}

templates/index/signed_in/active_jobs.html

@@ -1,6 +1,6 @@
 {% block active_jobs_section %}
 <ul id="active_jobs_section" class="list ">
-  <li class="py-4 text-xs opacity-60 tracking-wide">Active Jobs</li>
+  <li class="py-4 text-center text-xs opacity-60 tracking-wide">Active Jobs</li>
   {% for item in active_jobs %}
   <li class="list-row">
     <div class="bg-secondary rounded-box size-10 flex justify-center items-center text-secondary-content">

templates/index/signed_in/quick_actions.html

@@ -1,6 +1,4 @@
-<div class="shadow mt-4 rounded-box">
-  <div class="flex gap-4">
-    <button class="btn btn-primary" hx-get="/ingress-form" hx-swap="outerHTML">Add Content</button>
-    <a class="btn btn-secondary" href="/knowledge" hx-boost="true">View Knowledge</a>
-  </div>
+<div class="flex gap-4 flex-col">
+  <a class="btn btn-secondary" href="/knowledge" hx-boost="true">View Knowledge</a>
+  <button class="btn btn-primary" hx-get="/ingress-form" hx-swap="outerHTML">Add Content</button>
 </div>

templates/index/signed_in/recent_content.html

@@ -1,6 +1,6 @@
 {% block latest_content_section %}
 <ul id="latest_content_section" class="list">
-  <li class="py-4 text-xs opacity-60 tracking-wide">Recently added content</li>
+  <li class="py-4 text-center text-xs opacity-60 tracking-wide">Recently added content</li>
   {% for item in latest_text_contents %}
   <li class="list-row">
     <div class="bg-accent rounded-box size-10 flex justify-center items-center text-accent-content">

templates/index/signed_in/searchbar.html

@@ -1,10 +1,8 @@
-<div class="py-4 shadow rounded-box">
-  <h2>
-    Search your content
-  </h2>
-  <input type="text" placeholder="Search your knowledge base" class="input input-bordered w-full" name="query"
-    hx-get="/search" hx-target="#search-results" />
-  <div id="search-results" class="mt-4">
-    <!-- Results will be populated here by HTMX -->
-  </div>
+<h2>
+  Search your content
+</h2>
+<input type="text" placeholder="Search your knowledge base" class="input input-bordered w-full" name="query"
+  hx-get="/search" hx-target="#search-results" />
+<div id="search-results" class="mt-4">
+  <!-- Results will be populated here by HTMX -->
 </div>

templates/ingress_form.html

@@ -34,8 +34,8 @@
   </div>
   <div id="error-message" class="text-error text-center {% if not error %}hidden{% endif %}">{{ error }}</div>
   <div class="form-control mt-6 flex flex-col sm:flex-row gap-1">
+    <button type="submit" class="btn btn-primary w-full sm:w-fit">Submit</button>
     <button hx-get="/hide-ingress-form" hx-target="#ingress-form" hx-swap="outerHTML"
       class="btn btn-outline w-full sm:w-fit">Cancel</button>
-    <button type="submit" class="btn btn-primary w-full sm:w-fit">Submit</button>
   </div>
 </form>

templates/knowledge/base.html

@@ -2,12 +2,12 @@
 {% block main %}
 <main class="flex justify-center grow mt-2 sm:mt-4 gap-6">
   <div class="container">
-
+    {{plot_html|safe}}
     <h2>Entities</h2>
 
     {% for entity in entities %}
-    <p>{{entity.description}} /p>
-      {% endfor %}
+    <p>{{entity.id}} - {{entity.description}} </p>
+    {% endfor %}
 
 
     <h2 class="mt-10">Relationships</h2>