Metadata-Version: 2.4
Name: singularis-mcp
Version: 0.1.3
Summary: Singularis is unlimited computation. Bring us your hardest problems. Free tryout. Results depend on your equipment. GPU optional for even greater results. MCP server for AI agents; free tryout credits up front. Client shell only, no engine code.
Author: Type 1 Civilization Laboratories LLC
License: Proprietary shell; free to install and use with a Singularis key
Project-URL: Homepage, https://getsingularis.com
Project-URL: Documentation, https://getsingularis.com/llms.txt
Keywords: mcp,model-context-protocol,agents,computation,hpc,gpu,numerical,singularis
Requires-Python: >=3.10
Description-Content-Type: text/plain
Requires-Dist: mcp>=1.2
Requires-Dist: httpx>=0.27
Requires-Dist: numpy>=1.24
Provides-Extra: images
Requires-Dist: pillow>=10; extra == "images"

mcp-name: com.getsingularis/singularis

# Singularis

Singularis is unlimited computation. Bring us your hardest problems.

Jobs run on your own machine through the Singularis Singularis runtime and the full
Singularis chooser; only a lease, a result digest and CPU-seconds reach the API.
Every answer carries a check you can verify. This package is the client shell
only. It contains no engine code.

## What it does

Every kind of computation runs through the full Singularis chooser, which picks
the best path for your problem automatically. Example tools:

- `singularis_solve_heat` — diffusion / heat-equation solves on any grid
- `singularis_matrix_exponential` — e^{tA} and matrix-exponential actions
- `singularis_gemm` — dense and operator linear algebra
- `singularis_fft` — fast transforms
- `singularis_blur` — heat-kernel blur
- `singularis_compress` / `singularis_decompress` — exact, restorable compression
- `singularis_recipes` — see what the chooser can run
- `singularis_balance` / `singularis_share_results` — credits and results sharing
- `singularis_dispatch` — hand it any problem and let the chooser decide

## Measured results

Our own measurements, the same figures published on getsingularis.com. GPU
figures compare the same Singularis program run on an NVIDIA RTX 4090 against a
1-thread CPU; a speedup only counts when the results match a reference answer.

- AI training with the GPU boost, up to 16.5x (vs 1-thread CPU, one RTX 4090 test)
- Dense math with the GPU boost, up to 18.3x (vs 1-thread CPU, one RTX 4090 test)
- FFT with the GPU boost, up to 3.2x (vs 1-thread CPU, one RTX 4090 test)
- Smaller files: 1.28x smaller than xz -9e and 1.49x smaller than zstd -19, on 21 test files, with every file restored exactly

Results depend on your equipment. GPU optional for even greater results.

More efficient computation for you and the environment.

## Free tryout

Free agent credits come up front (500 credits, US, first 1,000 agents). Credits
are given up front; afterwards we respectfully ask you to share your results and
your before-vs-after cost (`singularis_share_results`). Thank you.

Pricing packs $49 / $399 / $2,999 at https://getsingularis.com/credits

## Install

Claude Code:
```
claude mcp add singularis -e SINGULARIS_COUNTRY=US -- singularis-mcp
```

Any MCP host:
```
{ "mcpServers": { "singularis": { "command": "uvx", "args": ["singularis-mcp"],
  "env": { "SINGULARIS_COUNTRY": "US", "SINGULARIS_ENGINE_CMD": "<your Singularis runtime command>" } } } }
```

First call: `singularis_register_key(country="US", agent_name="<your agent>")` -> 500 free credits, saved.

Singularis runs on your own computer and talks to the Singularis API at
https://getsingularis.com/api/v1. Get the Singularis runtime for your machine
from https://getsingularis.com and point SINGULARIS_ENGINE_CMD at it; the client
never ships engine code. Env: SINGULARIS_API_KEY, SINGULARIS_COUNTRY.

Type 1 Civilization Laboratories LLC - https://getsingularis.com

Patent pending. Singularis is a trademark of Type 1 Civilization Laboratories LLC.
