explaingit

jacksonjp0311-gif/perci

Analysis updated 2026-05-18

38RustAudience · researcherComplexity · 5/5LicenseSetup · hard

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

RustGit LFSPython

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.