exactor-cli 1.28.0__tar.gz → 1.29.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: exactor-cli
3
+ Version: 1.29.0
4
+ Summary: Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)
5
+ Author: Exactor Research
6
+ License: Proprietary
7
+ Project-URL: Homepage, https://exactor.tech
8
+ Project-URL: Documentation, https://exactor.tech/GETTING_STARTED.md
9
+ Project-URL: API, https://exactor.tech/public-swagger-ui
10
+ Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe,mpc,blif,aiger,eda,verilog,fsm
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # exactor-cli
20
+
21
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
22
+
23
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
24
+
25
+ ```bash
26
+ pip install exactor-cli
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Why Exactor
32
+
33
+ | | Typical EDA tools | **Exactor** |
34
+ |---|---|---|
35
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
36
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
37
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
38
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
39
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
40
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
41
+
42
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
43
+
44
+ ---
45
+
46
+ ## Quickstart — first simplification in 2 minutes
47
+
48
+ ```bash
49
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
50
+
51
+ # 2. Login
52
+ exactor login --token ek_YOUR_KEY
53
+
54
+ # 3. Minimize
55
+ exactor minimize circuit.pla -o out.v
56
+ ```
57
+
58
+ ```
59
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
60
+ Solver Latency: 16 ms
61
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
62
+ ```
63
+
64
+ No install at all? The API is plain HTTPS:
65
+
66
+ ```bash
67
+ curl -X POST https://exactor.tech/api/simplify \
68
+ -H "Authorization: Bearer ek_YOUR_KEY" \
69
+ -H "Content-Type: application/json" \
70
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
+ ```
72
+
73
+ ---
74
+
75
+ ## As a library
76
+
77
+ ```python
78
+ from exactor import ExactorClient, ExactorError
79
+
80
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
81
+
82
+ # Boolean function by minterms
83
+ res = client.simplify(variables=["a","b","c","d"],
84
+ minterms=[0,1,2,5,6,7],
85
+ emit=["verilog","metrics"])
86
+ print(res["result"], res["su_used"])
87
+
88
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
89
+ res = client.simplify_netlist(open("circuit.blif").read(),
90
+ fsm_minimize=True, fsm_init="0")
91
+
92
+ # Free dry-run analysis (0 SU)
93
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
94
+ ```
95
+
96
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
97
+
98
+ ---
99
+
100
+ ## What you can throw at it
101
+
102
+ - **`.pla`** — Espresso standard
103
+ - **`.json`** — `{variables, minterms, dont_cares}`
104
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
105
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
106
+ - **`.bench`** — ISCAS bench (Simplifier native)
107
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
108
+
109
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
110
+
111
+ ---
112
+
113
+ ## CLI reference
114
+
115
+ ```bash
116
+ exactor login --token ek_... # store credentials
117
+ exactor whoami / balance # plan + SU balance
118
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
119
+ exactor minimize big.pla --async --wait # distributed job for large inputs
120
+ exactor minimize net.json --fsm-minimize --fsm-init 0
121
+ exactor status <job_id> # async job polling
122
+ ```
123
+
124
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
125
+
126
+ ---
127
+
128
+ ## Billing — light jobs are free
129
+
130
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
131
+
132
+ ---
133
+
134
+ ## Links
135
+
136
+ - **Service & console:** https://exactor.tech
137
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
138
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
139
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
140
+
141
+ ---
142
+
143
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -0,0 +1,125 @@
1
+ # exactor-cli
2
+
3
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
4
+
5
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
6
+
7
+ ```bash
8
+ pip install exactor-cli
9
+ ```
10
+
11
+ ---
12
+
13
+ ## Why Exactor
14
+
15
+ | | Typical EDA tools | **Exactor** |
16
+ |---|---|---|
17
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
18
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
19
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
20
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
21
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
22
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
23
+
24
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
25
+
26
+ ---
27
+
28
+ ## Quickstart — first simplification in 2 minutes
29
+
30
+ ```bash
31
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
32
+
33
+ # 2. Login
34
+ exactor login --token ek_YOUR_KEY
35
+
36
+ # 3. Minimize
37
+ exactor minimize circuit.pla -o out.v
38
+ ```
39
+
40
+ ```
41
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
42
+ Solver Latency: 16 ms
43
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
44
+ ```
45
+
46
+ No install at all? The API is plain HTTPS:
47
+
48
+ ```bash
49
+ curl -X POST https://exactor.tech/api/simplify \
50
+ -H "Authorization: Bearer ek_YOUR_KEY" \
51
+ -H "Content-Type: application/json" \
52
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
53
+ ```
54
+
55
+ ---
56
+
57
+ ## As a library
58
+
59
+ ```python
60
+ from exactor import ExactorClient, ExactorError
61
+
62
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
63
+
64
+ # Boolean function by minterms
65
+ res = client.simplify(variables=["a","b","c","d"],
66
+ minterms=[0,1,2,5,6,7],
67
+ emit=["verilog","metrics"])
68
+ print(res["result"], res["su_used"])
69
+
70
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
71
+ res = client.simplify_netlist(open("circuit.blif").read(),
72
+ fsm_minimize=True, fsm_init="0")
73
+
74
+ # Free dry-run analysis (0 SU)
75
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
76
+ ```
77
+
78
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
79
+
80
+ ---
81
+
82
+ ## What you can throw at it
83
+
84
+ - **`.pla`** — Espresso standard
85
+ - **`.json`** — `{variables, minterms, dont_cares}`
86
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
87
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
88
+ - **`.bench`** — ISCAS bench (Simplifier native)
89
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
90
+
91
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
92
+
93
+ ---
94
+
95
+ ## CLI reference
96
+
97
+ ```bash
98
+ exactor login --token ek_... # store credentials
99
+ exactor whoami / balance # plan + SU balance
100
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
101
+ exactor minimize big.pla --async --wait # distributed job for large inputs
102
+ exactor minimize net.json --fsm-minimize --fsm-init 0
103
+ exactor status <job_id> # async job polling
104
+ ```
105
+
106
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
107
+
108
+ ---
109
+
110
+ ## Billing — light jobs are free
111
+
112
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
113
+
114
+ ---
115
+
116
+ ## Links
117
+
118
+ - **Service & console:** https://exactor.tech
119
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
120
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
121
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
122
+
123
+ ---
124
+
125
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -4,14 +4,18 @@ A high-performance cloud service for boolean function simplification using the E
4
4
 
5
5
  ## Features
6
6
 
7
- - Boolean function simplification via Exactor Engine (Superior to Quine-McCluskey/ESPRESSO, supports native XOR, AND, OR, and NOT with O(n) linear complexity).
8
- - Supports massive scale simplifications up to **128 variables** via Background Async Jobs processing.
9
- - Multi-format support: Accepts both `.json` (minterms) and Espresso `.pla` standard file formats.
10
- - RESTful API endpoints for synchronous simplification, asynchronous background file processing, and payments.
7
+ - Boolean function simplification via the Exactor Engine — canonical ESOP/XOR-native output (`xespresso`), verifiable per result.
8
+ - Structural netlist optimization (`/api/simplify/netlist`): hybrid DAG→minterm/structural path with XOR-native rewriting; accepts `exactor-netlist-v1` JSON **and competitor interchange formats — BLIF, ASCII AIGER `.aag`, ISCAS `.bench`** (auto-detected).
9
+ - Sequential coverage: flop/latch cut extraction + FSM state minimization (`fsm_minimize`, optional `fsm_init` reachability) — small enumerable machines.
10
+ - Multi-format output: `verilog`, `vhdl`, `blif`, `espresso`, `bristol`, `circom`, `testbench`, `yosys` script, `cert`.
11
+ - Python client + CLI: `pip install exactor-cli` → `exactor` command and `from exactor import ExactorClient` (see [GETTING_STARTED.md](GETTING_STARTED.md)).
12
+ - RESTful API endpoints for synchronous simplification, asynchronous background jobs, plans/billing (SU) and payments.
11
13
  - Built with async/await (`tokio` / `axum`) for high concurrency.
12
14
  - Comprehensive logging and tracing
13
15
  - Health check endpoint
14
16
 
17
+ > **Honest scope:** the SaaS self-service boundary is 128 variables / enumerable FSMs; larger designs are engineering-expansion projects. See `docs/exactor/competitive-parity.md` for the ABC/Yosys/Simplifier operations matrix.
18
+
15
19
  ## Prerequisites
16
20
 
17
21
  - Rust 1.70 or later
@@ -33,12 +37,22 @@ Exactor Cloud Service provides interactive API documentation using Swagger UI.
33
37
 
34
38
  ### Installation
35
39
 
40
+ > **Note:** this repository is private. End users don't need it — use the
41
+ > hosted API at `https://exactor.tech` (`pip install exactor-cli`, see
42
+ > [GETTING_STARTED.md](GETTING_STARTED.md)). Self-hosted/on-premise
43
+ > deployments are an Enterprise offering — contact us.
44
+
45
+ For contributors with repository access:
46
+
36
47
  1. Clone the repository:
37
48
  ```bash
38
- git clone https://github.com/yourusername/exactor.git
39
- cd exactor/exactor-cloud-service
49
+ git clone https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
50
+ cd exactor-cloud-service-v128
40
51
  ```
41
52
 
53
+ Or just use the hosted API at `https://exactor.tech` — no build needed
54
+ (`pip install exactor-cli`, see [GETTING_STARTED.md](GETTING_STARTED.md)).
55
+
42
56
  2. Build the project:
43
57
  ```bash
44
58
  cargo build --release
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: exactor-cli
3
+ Version: 1.29.0
4
+ Summary: Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)
5
+ Author: Exactor Research
6
+ License: Proprietary
7
+ Project-URL: Homepage, https://exactor.tech
8
+ Project-URL: Documentation, https://exactor.tech/GETTING_STARTED.md
9
+ Project-URL: API, https://exactor.tech/public-swagger-ui
10
+ Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe,mpc,blif,aiger,eda,verilog,fsm
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # exactor-cli
20
+
21
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
22
+
23
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
24
+
25
+ ```bash
26
+ pip install exactor-cli
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Why Exactor
32
+
33
+ | | Typical EDA tools | **Exactor** |
34
+ |---|---|---|
35
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
36
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
37
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
38
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
39
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
40
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
41
+
42
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
43
+
44
+ ---
45
+
46
+ ## Quickstart — first simplification in 2 minutes
47
+
48
+ ```bash
49
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
50
+
51
+ # 2. Login
52
+ exactor login --token ek_YOUR_KEY
53
+
54
+ # 3. Minimize
55
+ exactor minimize circuit.pla -o out.v
56
+ ```
57
+
58
+ ```
59
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
60
+ Solver Latency: 16 ms
61
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
62
+ ```
63
+
64
+ No install at all? The API is plain HTTPS:
65
+
66
+ ```bash
67
+ curl -X POST https://exactor.tech/api/simplify \
68
+ -H "Authorization: Bearer ek_YOUR_KEY" \
69
+ -H "Content-Type: application/json" \
70
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
+ ```
72
+
73
+ ---
74
+
75
+ ## As a library
76
+
77
+ ```python
78
+ from exactor import ExactorClient, ExactorError
79
+
80
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
81
+
82
+ # Boolean function by minterms
83
+ res = client.simplify(variables=["a","b","c","d"],
84
+ minterms=[0,1,2,5,6,7],
85
+ emit=["verilog","metrics"])
86
+ print(res["result"], res["su_used"])
87
+
88
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
89
+ res = client.simplify_netlist(open("circuit.blif").read(),
90
+ fsm_minimize=True, fsm_init="0")
91
+
92
+ # Free dry-run analysis (0 SU)
93
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
94
+ ```
95
+
96
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
97
+
98
+ ---
99
+
100
+ ## What you can throw at it
101
+
102
+ - **`.pla`** — Espresso standard
103
+ - **`.json`** — `{variables, minterms, dont_cares}`
104
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
105
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
106
+ - **`.bench`** — ISCAS bench (Simplifier native)
107
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
108
+
109
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
110
+
111
+ ---
112
+
113
+ ## CLI reference
114
+
115
+ ```bash
116
+ exactor login --token ek_... # store credentials
117
+ exactor whoami / balance # plan + SU balance
118
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
119
+ exactor minimize big.pla --async --wait # distributed job for large inputs
120
+ exactor minimize net.json --fsm-minimize --fsm-init 0
121
+ exactor status <job_id> # async job polling
122
+ ```
123
+
124
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
125
+
126
+ ---
127
+
128
+ ## Billing — light jobs are free
129
+
130
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
131
+
132
+ ---
133
+
134
+ ## Links
135
+
136
+ - **Service & console:** https://exactor.tech
137
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
138
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
139
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
140
+
141
+ ---
142
+
143
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -1,4 +1,4 @@
1
- GETTING_STARTED.md
1
+ PYPI_README.md
2
2
  README.md
3
3
  exactor_cli.py
4
4
  exactor_client.py
@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "exactor-cli"
7
- version = "1.28.0"
8
- description = "Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)"
9
- readme = "GETTING_STARTED.md"
7
+ version = "1.29.0"
8
+ description = "Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)"
9
+ readme = "PYPI_README.md"
10
10
  requires-python = ">=3.8"
11
11
  license = { text = "Proprietary" }
12
12
  authors = [{ name = "Exactor Research" }]
13
- keywords = ["boolean", "logic-minimization", "xor", "esop", "synthesis", "zk", "fhe"]
13
+ keywords = ["boolean", "logic-minimization", "xor", "esop", "synthesis", "zk", "fhe", "mpc", "blif", "aiger", "eda", "verilog", "fsm"]
14
14
  classifiers = [
15
15
  "Development Status :: 4 - Beta",
16
16
  "Environment :: Console",
@@ -22,6 +22,7 @@ dependencies = []
22
22
 
23
23
  [project.urls]
24
24
  Homepage = "https://exactor.tech"
25
+ Documentation = "https://exactor.tech/GETTING_STARTED.md"
25
26
  API = "https://exactor.tech/public-swagger-ui"
26
27
 
27
28
  [project.scripts]
@@ -1,126 +0,0 @@
1
- # Getting Started — primera simplificación en ~2 minutos
2
-
3
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
4
-
5
- ## 1. Consigue una API key
6
-
7
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
8
-
9
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
10
-
11
- ## 2. Instala el cliente
12
-
13
- ```bash
14
- # Opción A — pip (recomendada; paquete `exactor-cli`)
15
- pip install exactor-cli
16
-
17
- # Opción B — instaladores one-liner
18
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
19
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
20
-
21
- # Opción C — sin instalar: baja el archivo único
22
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
23
- ```
24
-
25
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
26
-
27
- ## 3. Login y minimiza
28
-
29
- ```bash
30
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
31
- exactor whoami # verifica tier y balance SU
32
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
33
- ```
34
-
35
- Salida real:
36
-
37
- ```
38
- [*] Circuit parsed: 4 inputs, 6 minterms.
39
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
40
- Solver Latency: 2195 ms
41
- Gate Reduction: 45.0%
42
- SU Consumed: 1 SU
43
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
44
- [*] Written synthesized output to: out.v
45
- ```
46
-
47
- O directo con curl — **sin instalar nada**:
48
-
49
- ```bash
50
- curl -X POST https://exactor.tech/api/simplify \
51
- -H "Authorization: Bearer ek_TU_API_KEY" \
52
- -H "Content-Type: application/json" \
53
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
54
- ```
55
-
56
- ## Formato de entrada
57
-
58
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
59
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
60
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
61
-
62
- ## Como librería Python
63
-
64
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
65
-
66
- ```python
67
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
68
-
69
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
70
-
71
- # Función booleana por minterms
72
- res = client.simplify(variables=["a","b","c","d"],
73
- minterms=[0,1,2,5,6,7],
74
- emit=["verilog","metrics"])
75
- print(res["result"], "| su_used:", res["su_used"])
76
-
77
- # Pre-análisis gratis (0 SU)
78
- print(client.analyze(["a","b","c"], [0,1,5,7]))
79
-
80
- # Netlist estructural (exactor-netlist-v1) con FSM
81
- res = client.simplify_netlist(open("net.json").read(),
82
- fsm_minimize=True, fsm_init="0")
83
- print(res["fsm_analysis"], res["minimized_state_bits"])
84
-
85
- # Cuenta
86
- print(client.me(), client.balance())
87
- ```
88
-
89
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
90
-
91
- ## Variantes del CLI
92
-
93
- ```bash
94
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
95
- exactor status <job_id> # consulta un job async
96
- exactor balance # saldo SU del plan
97
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
98
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
99
- ```
100
-
101
- ## Billing en una línea
102
-
103
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
104
-
105
- ## Self-host (opcional)
106
-
107
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
108
-
109
- ```bash
110
- git clone <repo> && cd exactor-cloud-service-v128
111
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
112
- ```
113
-
114
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
115
-
116
- ## Troubleshooting
117
-
118
- | Síntoma | Causa | Fix |
119
- |---|---|---|
120
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
121
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
122
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
123
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
124
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
125
-
126
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
@@ -1,143 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: exactor-cli
3
- Version: 1.28.0
4
- Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
- Author: Exactor Research
6
- License: Proprietary
7
- Project-URL: Homepage, https://exactor.tech
8
- Project-URL: API, https://exactor.tech/public-swagger-ui
9
- Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe
10
- Classifier: Development Status :: 4 - Beta
11
- Classifier: Environment :: Console
12
- Classifier: Intended Audience :: Science/Research
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
15
- Requires-Python: >=3.8
16
- Description-Content-Type: text/markdown
17
-
18
- # Getting Started — primera simplificación en ~2 minutos
19
-
20
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
21
-
22
- ## 1. Consigue una API key
23
-
24
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
25
-
26
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
27
-
28
- ## 2. Instala el cliente
29
-
30
- ```bash
31
- # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli
33
-
34
- # Opción B — instaladores one-liner
35
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
36
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
37
-
38
- # Opción C — sin instalar: baja el archivo único
39
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
40
- ```
41
-
42
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
43
-
44
- ## 3. Login y minimiza
45
-
46
- ```bash
47
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
48
- exactor whoami # verifica tier y balance SU
49
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
50
- ```
51
-
52
- Salida real:
53
-
54
- ```
55
- [*] Circuit parsed: 4 inputs, 6 minterms.
56
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
57
- Solver Latency: 2195 ms
58
- Gate Reduction: 45.0%
59
- SU Consumed: 1 SU
60
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
61
- [*] Written synthesized output to: out.v
62
- ```
63
-
64
- O directo con curl — **sin instalar nada**:
65
-
66
- ```bash
67
- curl -X POST https://exactor.tech/api/simplify \
68
- -H "Authorization: Bearer ek_TU_API_KEY" \
69
- -H "Content-Type: application/json" \
70
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
- ```
72
-
73
- ## Formato de entrada
74
-
75
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
78
-
79
- ## Como librería Python
80
-
81
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
82
-
83
- ```python
84
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
85
-
86
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
87
-
88
- # Función booleana por minterms
89
- res = client.simplify(variables=["a","b","c","d"],
90
- minterms=[0,1,2,5,6,7],
91
- emit=["verilog","metrics"])
92
- print(res["result"], "| su_used:", res["su_used"])
93
-
94
- # Pre-análisis gratis (0 SU)
95
- print(client.analyze(["a","b","c"], [0,1,5,7]))
96
-
97
- # Netlist estructural (exactor-netlist-v1) con FSM
98
- res = client.simplify_netlist(open("net.json").read(),
99
- fsm_minimize=True, fsm_init="0")
100
- print(res["fsm_analysis"], res["minimized_state_bits"])
101
-
102
- # Cuenta
103
- print(client.me(), client.balance())
104
- ```
105
-
106
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
107
-
108
- ## Variantes del CLI
109
-
110
- ```bash
111
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
112
- exactor status <job_id> # consulta un job async
113
- exactor balance # saldo SU del plan
114
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
115
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
116
- ```
117
-
118
- ## Billing en una línea
119
-
120
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
121
-
122
- ## Self-host (opcional)
123
-
124
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
125
-
126
- ```bash
127
- git clone <repo> && cd exactor-cloud-service-v128
128
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
129
- ```
130
-
131
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
132
-
133
- ## Troubleshooting
134
-
135
- | Síntoma | Causa | Fix |
136
- |---|---|---|
137
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
138
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
139
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
140
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
141
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
142
-
143
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
@@ -1,143 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: exactor-cli
3
- Version: 1.28.0
4
- Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
- Author: Exactor Research
6
- License: Proprietary
7
- Project-URL: Homepage, https://exactor.tech
8
- Project-URL: API, https://exactor.tech/public-swagger-ui
9
- Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe
10
- Classifier: Development Status :: 4 - Beta
11
- Classifier: Environment :: Console
12
- Classifier: Intended Audience :: Science/Research
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
15
- Requires-Python: >=3.8
16
- Description-Content-Type: text/markdown
17
-
18
- # Getting Started — primera simplificación en ~2 minutos
19
-
20
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
21
-
22
- ## 1. Consigue una API key
23
-
24
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
25
-
26
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
27
-
28
- ## 2. Instala el cliente
29
-
30
- ```bash
31
- # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli
33
-
34
- # Opción B — instaladores one-liner
35
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
36
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
37
-
38
- # Opción C — sin instalar: baja el archivo único
39
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
40
- ```
41
-
42
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
43
-
44
- ## 3. Login y minimiza
45
-
46
- ```bash
47
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
48
- exactor whoami # verifica tier y balance SU
49
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
50
- ```
51
-
52
- Salida real:
53
-
54
- ```
55
- [*] Circuit parsed: 4 inputs, 6 minterms.
56
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
57
- Solver Latency: 2195 ms
58
- Gate Reduction: 45.0%
59
- SU Consumed: 1 SU
60
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
61
- [*] Written synthesized output to: out.v
62
- ```
63
-
64
- O directo con curl — **sin instalar nada**:
65
-
66
- ```bash
67
- curl -X POST https://exactor.tech/api/simplify \
68
- -H "Authorization: Bearer ek_TU_API_KEY" \
69
- -H "Content-Type: application/json" \
70
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
- ```
72
-
73
- ## Formato de entrada
74
-
75
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
78
-
79
- ## Como librería Python
80
-
81
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
82
-
83
- ```python
84
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
85
-
86
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
87
-
88
- # Función booleana por minterms
89
- res = client.simplify(variables=["a","b","c","d"],
90
- minterms=[0,1,2,5,6,7],
91
- emit=["verilog","metrics"])
92
- print(res["result"], "| su_used:", res["su_used"])
93
-
94
- # Pre-análisis gratis (0 SU)
95
- print(client.analyze(["a","b","c"], [0,1,5,7]))
96
-
97
- # Netlist estructural (exactor-netlist-v1) con FSM
98
- res = client.simplify_netlist(open("net.json").read(),
99
- fsm_minimize=True, fsm_init="0")
100
- print(res["fsm_analysis"], res["minimized_state_bits"])
101
-
102
- # Cuenta
103
- print(client.me(), client.balance())
104
- ```
105
-
106
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
107
-
108
- ## Variantes del CLI
109
-
110
- ```bash
111
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
112
- exactor status <job_id> # consulta un job async
113
- exactor balance # saldo SU del plan
114
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
115
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
116
- ```
117
-
118
- ## Billing en una línea
119
-
120
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
121
-
122
- ## Self-host (opcional)
123
-
124
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
125
-
126
- ```bash
127
- git clone <repo> && cd exactor-cloud-service-v128
128
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
129
- ```
130
-
131
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
132
-
133
- ## Troubleshooting
134
-
135
- | Síntoma | Causa | Fix |
136
- |---|---|---|
137
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
138
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
139
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
140
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
141
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
142
-
143
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
File without changes