gitwtfhub

wtf is perci?

jacksonjp0311-gif/perci — explained in plain English

Analysis updated 2026-05-18

38RustAudience · researcherComplexity · 5/5LicenseSetup · hard

TL;DR

Perci is a local-first, Rust-built AI assistant that separates reasoning into a compact binary model, named operators, and exact math tools, with all weight changes requiring human approval.

Mindmap

mindmap
  root((perci))
    What it does
      Local AI assistant
      Bitwork routing model
      Named operators
      Exact math tools
    Tech stack
      Rust
      Git LFS
      Python scripts
    Use cases
      Offline AI assistant
      Inspectable reasoning
      Research on hybrid AI
    Audience
      Researchers
      AI systems tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a local, offline AI assistant that keeps its reasoning and data entirely on your own machine.

REASON 2

Inspect an AI assistant's internal reasoning trace and routing decisions using built-in debug commands.

REASON 3

Study a neuro-symbolic architecture that combines exact math tools with a compact learned model.

What's in the stack?

RustGit LFSPython

How it stacks up

jacksonjp0311-gif/percibbalabs/athanor-liteadysec/clawbot
Stars383837
LanguageRustRustRust
Setup difficultyhardeasymoderate
Complexity5/52/53/5
Audienceresearchervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires Git LFS to pull a ~200MB model package and running verification scripts before first use.

Dual-licensed MIT or Apache 2.0, use freely for any purpose including commercial use.

Wtf does this do

Perci is an experimental AI assistant written in Rust that is meant to run entirely on your own machine instead of relying on a cloud AI service. The project describes itself as a small operating system for thinking, built by separating different jobs that most chat assistants hide inside one large model. It has a compact binary knowledge structure called Bitwork, about 200 megabytes in size, that handles routing and pattern matching. It has named procedures called operators that handle things like deciding whether to trust an instruction, planning a response, or writing code. It also has exact tools for math and geometry that calculate real answers instead of guessing, and a governance layer that checks results before anything is allowed to change the system permanently. When you send Perci a message, it first checks for quick reflex style responses or exact calculations, then routes the message through its Bitwork field, applies the relevant operators, and if needed builds a longer chain of reasoning that gets rewritten into plain, conversational language before being shown to you. You can inspect what happened behind a response using special commands that reveal its internal reasoning trace, and you can adjust how concise or detailed its answers are. The project places heavy emphasis on testing and measurement, publishing tables of pass and fail results from its own internal test suites that check reasoning correctness, dialogue behavior, and security boundaries, along with scripts you can run yourself to reproduce those results. Importantly, the underlying model weights can never update automatically. Any permanent change requires a human to explicitly authorize it. The full runtime package, including the Bitwork model files, is distributed through Git LFS and must be pulled down separately after cloning the repository. Perci is dual licensed under MIT or Apache 2.0.

Yoink these prompts

Prompt 1
How do I clone Perci, pull its Git LFS model files, and verify the runtime package?
Prompt 2
Explain how Perci routes a message through Bitwork, operators, and exact tools before responding.
Prompt 3
What do Perci's /think, /field, and /trace commands show about its internal reasoning?
Prompt 4
How does Perci ensure model weight changes always require explicit human authorization?

Frequently asked questions

wtf is perci?

Perci is a local-first, Rust-built AI assistant that separates reasoning into a compact binary model, named operators, and exact math tools, with all weight changes requiring human approval.

What language is perci written in?

Mainly Rust. The stack also includes Rust, Git LFS, Python.

What license does perci use?

Dual-licensed MIT or Apache 2.0, use freely for any purpose including commercial use.

How hard is perci to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is perci for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.