# Install Inillucent

You are installing **Inillucent 2.8.1**, MIT licensed: an embedded SQL database with vector
and keyword search in one file. It installs `inillucent` (the command line, with `--output
json` on every command), `inillucent-shell` (shaped like `sqlite3`), `inillucent-mcp` (an MCP
server), `inillucent-migrate` (SQLite, PostgreSQL or MySQL in, one verified database out), and the
C library with its header. Nothing is written outside the home directory and nothing needs
administrator rights.

## 1. Install, for this operating system

Check `uname -s` (`Darwin`, `Linux`) or for Windows, then follow one section.

### Windows

```powershell
irm https://inillucent.com/downloads/install.ps1 | iex
```

Unpacks into `%LOCALAPPDATA%\Programs\inillucent` and adds its `bin` to the user PATH.

### Linux, x86-64 or ARM

```sh
curl -fsSL https://inillucent.com/downloads/install.sh | sh
```

The script reads `uname -m` and picks `x86_64-unknown-linux-gnu` or `aarch64-unknown-linux-gnu`
itself. It unpacks into `~/.local/share/inillucent` and links the four programs into
`~/.local/bin`. glibc 2.28 or newer.

### macOS

```sh
curl -fsSL https://inillucent.com/downloads/install.sh | sh
```

The same script as Linux. It picks the universal archive, which runs on Apple silicon and Intel,
and installs it the same way. There is also a signed installer package at
https://inillucent.com/downloads/inillucent-2.8.1.pkg.

## 2. PATH, if the script did not set it

Windows sets the user PATH itself, so open a new terminal; if the command is still not found, add
`%LOCALAPPDATA%\Programs\inillucent\bin`. On Linux and macOS add the bin directory, usually with
`export PATH="$HOME/.local/bin:$PATH"` in `~/.bashrc` or `~/.zshrc`.

## 3. Check it worked

```sh
inillucent --version
```

It must print `inillucent 2.8.1`. Not found means PATH, not the install: open a new terminal.

## 4. Make the first database

```sh
inillucent create app.rdb
inillucent --db app.rdb exec "CREATE TABLE note (id INTEGER PRIMARY KEY, body TEXT)"
inillucent --db app.rdb query "SELECT * FROM note"
```

Exit code 3 means "this engine has not built that", a different code from 1 on purpose: it is not a
syntax error, so do not start rewording the SQL.

## 5. Register the MCP server

Point `--root` at the directory the agent works in, so the server refuses every path resolving
outside it. `--readonly` refuses every statement that would change something; leave it off if the
agent should be able to write.

In **Claude Code** and in **Codex** the server command goes after a `--`:

```sh
claude mcp add inillucent -- inillucent-mcp --db app.rdb --root .
codex  mcp add inillucent -- inillucent-mcp --db app.rdb --root .
```

**Any other client**, in its own config:

```json
{
  "mcpServers": {
    "inillucent": {
      "command": "inillucent-mcp",
      "args": ["--db", "app.rdb", "--root", ".", "--readonly"]
    }
  }
}
```

Confirm it registered with `claude mcp list` or `codex mcp list`.

## The archives, and their checksums

- **Windows** — `inillucent-2.8.1-x86_64-pc-windows-msvc.zip` (x86-64 · 26 MB), SHA-256 `bfc5c07574881502c2414f26f1b83b923e530e031061173a323097f1b961f889`
- **macOS** — `inillucent-2.8.1.pkg` (Apple silicon and Intel, signed and notarised · 52.2 MB), SHA-256 `49ea924c1980960ab718add823a170ddead4ba83c2da2661ba6d61690e572891`
- **macOS archive** — `inillucent-2.8.1-universal-apple-darwin.tar.gz` (Apple silicon and Intel · 54.4 MB), SHA-256 `8f5a579c794cb2efda1e3311bb7ecc6f44b7a1d7433edc882a90a41800478696`
- **Linux** — `inillucent-2.8.1-x86_64-unknown-linux-gnu.tar.gz` (x86-64, glibc 2.28 or newer · 27.7 MB), SHA-256 `fc16ee47a982a6890759a07452751bf4a7334f73ccd9fc0d56aab54abb96dea7`
- **Linux ARM** — `inillucent-2.8.1-aarch64-unknown-linux-gnu.tar.gz` (aarch64, glibc 2.28 or newer · 26 MB), SHA-256 `083f2dfa3b11866c48e212b8de910fce4d2d1bb812ce5904e5841fa48727ea23`
- **Debian and Ubuntu** — `inillucent_2.8.1_amd64.deb` (x86-64 · 27.4 MB), SHA-256 `41854e5799b52d04cf159cbca8d2c42ddc8c701e6c7a473dac861d79c408a582`
- **Fedora and RHEL** — `inillucent-2.8.1.x86_64.rpm` (x86-64 · 27.2 MB), SHA-256 `ac9fe17b5f568548b01f370a33227af8a87013eaf0d89c41b952c28b6be50ead`
- **Debian and Ubuntu ARM** — `inillucent_2.8.1_arm64.deb` (aarch64 · 25.9 MB), SHA-256 `04626c2aad35205679995aca9a75f4e91db0df4255b3a46206b2f90c9e40a8e4`
- **Fedora and RHEL ARM** — `inillucent-2.8.1.aarch64.rpm` (aarch64 · 25.5 MB), SHA-256 `1c9f14ca7611b06eff6e2255e1b7ea366bcfc93e01d700b2b26a5208c4cd0a89`

Both install scripts check the archive against <https://inillucent.com/downloads/SHA256SUMS> before
unpacking. The documentation has a chapter for each job, each with the exact input and the output to expect:
<https://inillucent.com/docs>

## The prompt that sent you here

```
Download and install Inillucent on this machine. It is an embedded SQL database with vector and keyword search, in one file, with an MCP server.

1. Fetch https://inillucent.com/install.md and follow the steps for my operating system.
2. Confirm it worked by running `inillucent --version`.
3. Register the MCP server with this agent using the MCP section of that page.
4. Then tell me the version you installed, where the four programs are, and the command that creates my first database.
```