Astucia Wiki

official

AI enabled team wiki

View on astucia.wiki

What can you do with Astucia Wiki?

  • Search and retrieve wiki pages — Use search_pages to find pages by keyword and get_page to fetch full Markdown content with metadata.
  • Create and update Markdown pages — Ask the AI to draft or edit wiki content via create_page and update_page, with automatic Git versioning on every save.
  • Manage structured lists — Work with spreadsheet-style data tables through list_rows, add_row, update_row, and delete_row for typed-column records.
  • Interact with diagrams — Retrieve draw.io diagram source with get_diagram and update it via update_diagram so the SVG preview stays in sync.
  • Read and post in team chat — Use get_chat_messages and post_chat_message to participate in threaded discussions with @mentions and emoji support.
  • Schedule recurring AI agent jobs — Configure automated agents that read and write pages on a schedule, with failure alerts sent by email.

Documentation

Open Source · Self-Hosted · No Database

Your team's knowledge base,

without the complexity

Astucia Wiki is a flat-file, self-hosted wiki that combines Markdown pages, draw.io diagrams, spreadsheet lists, and team chat — all stored as plain files on disk. No database. No heavy framework. Just fast, organised knowledge.

Install on Debian Explore features

0

Databases required

AI

AI-enabled

PHP

Only dependency

OIDC

SSO ready

Introduction video

Features

Everything your team needs to stay organised

Seventeen tightly integrated features, zero external services required. Click any card to read the full feature guide.

Markdown Pages

Write in Markdown with a full-featured editor. Classic and inline editing modes, keyboard shortcuts, find & replace, content transclusion, inline table of contents, and print-ready pages.

Learn more →

Diagrams (draw.io)

Create and edit diagrams directly inside the wiki using the embedded draw.io editor. Diagrams render as SVG previews in pages and can be embedded inline with a simple tag.

Learn more →

Structured Lists

Spreadsheet-style data tables with typed columns (text, date, choice, auto-increment), named views, filters, column ordering, and CSV / XML export.

Learn more →

Team Chat

Threaded chat as standalone files in the wiki tree — real-time polling, emoji picker, user mentions with autocomplete, message grouping, and optional topic banners.

Learn more →

Page Chat

A chat panel attached directly to any Markdown page. AI assistants receive the full page content as automatic context — and if they update the page, the viewer refreshes live with a toast notification.

Learn more →

Search & Tags

Full-text search across all pages with result previews, timestamps, and author attribution. Tag any page and browse the interactive tag cloud to filter by topic.

Learn more →

Spaces

Divide your wiki into isolated workspaces — one per team, project, or department. Switch instantly from the sidebar, with per-user access control for each space.

Learn more →

File Attachments

Attach any file to any page by drag-and-drop or file picker. Attachments are stored per-page, access-controlled, and available for direct download.

Learn more →

Auth & Access Control

Optional OIDC / Auth0 single sign-on with three roles (admin, editor, viewer) plus anonymous reader access for public browsing. Per-space restrictions, session timeout, and email notifications for access requests.

Learn more →

File Management

Create folders and nested hierarchies. Rename, copy, and move any page or folder — including across Spaces. All operations keep the page index in sync automatically.

Learn more →

AI Assistants

Add AI bots backed by Claude, GPT, or any OpenAI-compatible model. Trigger them with @mentions in any chat thread, or open a Page Chat panel on any Markdown page for AI with automatic page context. Bots can read and write wiki pages as tools during a response.

Learn more →

Git Version History

Automatic commits on every save, with renames and moves tracked as proper git renames so history follows files across reorganisations. Manual snapshots for chats and lists. One-click restore for any version.

Learn more →

Localization

Full UI translation in English, Danish, Swedish, Spanish, French, and German. Each user picks their language from the sidebar — stored in the browser, no account required.

Learn more →

AI Agent Jobs

Schedule AI agents to run automatically — daily, on specific weekdays, or monthly. Each job uses an agentic loop to read and write wiki pages, with failure alerts sent by email.

Learn more →

Page & Diagram Templates

Start new pages and diagrams from structured templates. Ten bundled templates cover meeting notes, decision records, how-to guides, API references, and more. Add your own per-space templates at any time.

Learn more →

Share by E-mail

Send any page to colleagues with one click. Choose everyone or specific recipients with type-ahead search. The e-mail includes a deep link that opens the exact page in the correct Space.

Learn more →

Reader / Anonymous Access

Let visitors browse and read the wiki without logging in. Authentication still protects editing; reader access can be enabled globally or restricted per space — ideal for public-facing knowledge bases.

Learn more →

MCP — Model Context Protocol

Connect any MCP client — Claude Desktop, Claude Code, your own agent — straight to the wiki's pages. AI Users can likewise call out to external MCP tool servers as part of their replies.

Learn more →

AI

An essential part of your AI setup

Astucia Wiki isn't just AI-enabled — it's built so AI assistants work directly inside your team's real knowledge, with the tools and boundaries you define, instead of a generic chatbot bolted on the side.

Assistance in the Context of Your Documents

AI Users don't answer from a blank slate. Attach one to a chat thread or open a Page Chat panel and it reads, reasons over, and writes directly to your actual wiki pages — with the full page content as automatic context, not a copy-pasted excerpt.

See it in action →

A Purpose for Every AI User

Give each AI User its own system prompt, model, and role — a #Writer for drafting, a #Reviewer for critique, a #Tagger for housekeeping. Clone an existing user to spin up a new specialist in seconds, sharing the same underlying model.

Configure AI Users →

Bring Your Own Tools via MCP

Register any MCP server — a search engine, a ticketing system, another wiki — and decide exactly which AI Users may call it, and when, with plain-English per-server instructions instead of code.

Connect an MCP server →

Your Wiki, Part of a Bigger Ecosystem

Expose any Astucia Wiki as an MCP server of its own. Another team's wiki, or any MCP-aware client, can then read and write your pages directly — turning isolated wikis into one connected knowledge network for cross-team collaboration.

Expose your wiki →

Philosophy

No database. No cloud. No lock-in.

Every page, diagram, list, and chat thread is a plain file on disk. Back up your wiki with rsync. Version it with Git. Restore it from a zip. No database migrations, no connection pools, no cloud vendor to depend on.

Astucia Wiki is built on PHP with no front-end build step. Deploy it on any shared host, VPS, or Raspberry Pi. Serve it over Nginx or Apache. The only moving part is a JSON index file that is rebuilt automatically.

Read the install guide

# Deploy in minutes
git clone https://github.com/madsrg/astucia-wiki
cd astucia-wiki
composer install

# Run locally
php -S localhost:8000

# Backup is just a folder copy
rsync -av /var/wiki/Pages/ backup/

Support

Questions or feedback?

Open an issue or start a discussion on GitHub — bug reports, feature requests, and general questions are all welcome.

Go to GitHub →

Ready to get started?

Follow the step-by-step guide to install Astucia Wiki on Debian with Nginx and PHP in under 15 minutes.

View Installation Guide →