feat: add DeepSeek and NVIDIA NIM providers

- Add deepseek and nvidia entries to gateway-provider config

- Add DEEPSEEK_API_KEY and NVIDIA_API_KEY to .env.example

- Add deepseek and nvidia to doctor's LLM provider check

- Fix remaining harness-log → log-message reference
This commit is contained in:
2026-05-02 22:25:24 -04:00
parent d803889c01
commit 95d1ea3fed
100 changed files with 5344 additions and 2743 deletions

View File

@@ -1,25 +1,25 @@
#+TITLE: OpenCortex User Manual
#+AUTHOR: OpenCortex Contributors
#+TITLE: Passepartout User Manual
#+AUTHOR: Passepartout Contributors
#+STARTUP: content
#+FILETAGS: :docs:manual:
* Introduction
Welcome to OpenCortex v0.1.0 (The Autonomous Foundation). OpenCortex is a neurosymbolic AI agent and a Lisp Machine operating system designed to autonomously maintain your Memex (knowledge base) and interact with you via multiple, equal-citizen interfaces.
Welcome to Passepartout v0.1.0 (The Autonomous Foundation). Passepartout is a neurosymbolic AI agent and a Lisp Machine operating system designed to autonomously maintain your Memex (knowledge base) and interact with you via multiple, equal-citizen interfaces.
* Installation
OpenCortex is bootstrapped via a single shell script.
Passepartout is bootstrapped via a single shell script.
** Quick start (curl)
#+begin_src bash
curl -fsSL https://raw.githubusercontent.com/amrgharbeia/opencortex/main/opencortex.sh | bash -s configure
curl -fsSL https://raw.githubusercontent.com/amrgharbeia/passepartout/main/passepartout.sh | bash -s configure
#+end_src
** From a clone
#+begin_src bash
git clone https://github.com/amrgharbeia/opencortex.git ~/projects/opencortex
~/projects/opencortex/opencortex.sh configure
git clone https://github.com/amrgharbeia/passepartout.git ~/projects/passepartout
~/projects/passepartout/passepartout.sh configure
#+end_src
Both methods will:
@@ -37,33 +37,33 @@ The system is configured via a `.env` file in the project root. Essential variab
- `PROVIDER_CASCADE`: The fallback order for LLM providers (e.g., `openrouter,ollama,anthropic`).
- `MEMEX_DIR`: The absolute path to your knowledge base (defaults to `~/memex`).
* Interacting with OpenCortex
* Interacting with Passepartout
Because of the Unified Envelope Architecture, the kernel treats all clients as interchangeable. You must first boot the background daemon:
#+begin_src bash
./opencortex.sh --boot &
./passepartout.sh --boot &
#+end_src
** Terminal User Interface (TUI)
For a rich, split-pane terminal experience:
#+begin_src bash
./opencortex.sh tui
./passepartout.sh tui
#+end_src
** Command Line Interface (CLI)
For raw, pipe-friendly interaction:
#+begin_src bash
./opencortex.sh cli
./passepartout.sh cli
#+end_src
** Emacs Integration
OpenCortex functions as your "foveal vision" inside Emacs.
Passepartout functions as your "foveal vision" inside Emacs.
1. Ensure `org-agent.el` is loaded.
2. Run `M-x opencortex-connect`.
3. Interact via the `*opencortex-chat*` buffer.
2. Run `M-x passepartout-connect`.
3. Interact via the `*passepartout-chat*` buffer.
* The Memex Structure
OpenCortex assumes a local folder structure representing your "Memex".
Passepartout assumes a local folder structure representing your "Memex".
- Core memories and identities are mapped to Org-mode files.
- The `Scribe` background worker distills chronological logs into structured Zettelkasten notes.
- The `Gardener` continuously repairs broken links and flags orphaned nodes.
@@ -75,9 +75,9 @@ OpenCortex assumes a local folder structure representing your "Memex".
The ~configure~ command supports both Debian-based (Ubuntu, Pop, Mint) and Fedora-based (RHEL, Rocky) distributions. It detects your distro automatically and installs the correct packages.
#+begin_src bash
./opencortex.sh configure # interactive
./opencortex.sh configure --non-interactive # headless
./opencortex.sh configure --with-firewall # also open port 9105
./passepartout.sh configure # interactive
./passepartout.sh configure --non-interactive # headless
./passepartout.sh configure --with-firewall # also open port 9105
#+end_src
After configuration, you can re-run ~configure~ any time to add providers or link gateways.
@@ -85,15 +85,15 @@ After configuration, you can re-run ~configure~ any time to add providers or lin
** systemd service (auto-start on boot)
#+begin_src bash
./opencortex.sh install service
./passepartout.sh install service
#+end_src
Installs a user-level systemd unit that starts the daemon on login. Logs are available via ~journalctl --user -u opencortex.service -f~.
Installs a user-level systemd unit that starts the daemon on login. Logs are available via ~journalctl --user -u passepartout.service -f~.
To remove:
#+begin_src bash
./opencortex.sh uninstall service
./passepartout.sh uninstall service
#+end_src
** Docker
@@ -110,7 +110,7 @@ This builds an image from ~debian:trixie-slim~ with all dependencies pre-install
** Backup
#+begin_src bash
./opencortex.sh backup ~/my-backup.tar.gz
./passepartout.sh backup ~/my-backup.tar.gz
#+end_src
Backs up the config, data, and memex directories.
@@ -118,7 +118,7 @@ Backs up the config, data, and memex directories.
** Restore
#+begin_src bash
./opencortex.sh restore ~/my-backup.tar.gz
./passepartout.sh restore ~/my-backup.tar.gz
#+end_src
Restores from a backup file. Run ~opencortex doctor~ afterward to verify integrity.
Restores from a backup file. Run ~passepartout doctor~ afterward to verify integrity.