Metadata-Version: 2.4
Name: unlimited-skills
Version: 0.6.1
Summary: A local skill retrieval library for coding agents: lexical search, vector sidecar search, warm daemon mode, and learning-loop logs.
Project-URL: Homepage, https://github.com/AI4sale/unlimited-skills
Project-URL: Repository, https://github.com/AI4sale/unlimited-skills
Project-URL: Issues, https://github.com/AI4sale/unlimited-skills/issues
Project-URL: Changelog, https://github.com/AI4sale/unlimited-skills/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/AI4sale/unlimited-skills/tree/main/docs
Author: AI4sale
License-Expression: MIT
License-File: LICENSE
Keywords: agents,chroma,claude-code,codex,rag,retrieval,skills
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: cryptography<47,>=42
Requires-Dist: pyyaml<7,>=6
Provides-Extra: all
Requires-Dist: chromadb<2,>=1.0; extra == 'all'
Requires-Dist: fastapi>=0.115; extra == 'all'
Requires-Dist: fastembed>=0.4; extra == 'all'
Requires-Dist: uvicorn>=0.30; extra == 'all'
Provides-Extra: server
Requires-Dist: fastapi>=0.115; extra == 'server'
Requires-Dist: uvicorn>=0.30; extra == 'server'
Provides-Extra: vector
Requires-Dist: chromadb<2,>=1.0; extra == 'vector'
Requires-Dist: fastembed>=0.4; extra == 'vector'
Description-Content-Type: text/markdown

# Unlimited Skills

Unlimited Skills is a local-first skill memory and retrieval layer for coding
agents. It keeps large skill libraries out of the agent context and retrieves
the small, relevant skill context only when it is useful.

This is `v0.6.1-alpha`: a public alpha of the free MIT local core. There is no
telemetry, no hosted dependency for local use, and nothing for sale in this
release. APIs and JSON output may change before `1.0`.

## Install

```bash
pip install unlimited-skills
unlimited-skills quickstart
```

For hybrid/vector search:

```bash
pip install "unlimited-skills[vector]"
unlimited-skills vector-reindex
```

## What Quickstart Proves

`unlimited-skills quickstart` is the first-value path for a clean install:

- imports the bundled ECC and Superpowers packs when your local library is
  empty;
- indexes the local skill library;
- runs a first search so you can see retrieval working;
- measures local MCP context savings when a Claude Code config is available;
- prints local next steps without uploading prompts, schemas, configs, or
  skill bodies.

The package smoke for this release verifies the wheel in a fresh virtual
environment: `unlimited-skills --version`, `quickstart`, `suggest`,
`mcp savings`, `feedback prepare`, `learning-summary --events`, and
`roi receipt` all run from the installed package.

## Measured, Not Promised

Current release-gate measurements on the bundled library:

- skill retrieval eval: top-1 `0.933`, top-3 `0.967`, false positives `0`;
- MCP lab benchmark: `90,420` bytes of direct tool schemas versus `1,268`
  bytes behind the Unlimited Tools gateway.

Your local results depend on your installed skills and MCP servers. Run
`unlimited-skills mcp savings --json` to measure your own configuration.

## Local-First Boundaries

- No telemetry or automatic uploads.
- No skill execution by the library.
- No paid, hosted, Team, Pro, Business, or Enterprise feature is required for
  local search, quickstart, suggestion, indexing, or MCP savings.
- Hosted/registered catalog and team surfaces are early alpha paths documented
  in the repository; they are not required for the local core.

## Useful Links

- Repository: https://github.com/AI4sale/unlimited-skills
- Quickstart docs: https://github.com/AI4sale/unlimited-skills/blob/main/docs/quickstart.md
- Feedback guide: https://github.com/AI4sale/unlimited-skills/blob/main/docs/feedback.md
- Known limitations: https://github.com/AI4sale/unlimited-skills/blob/main/docs/releases/v0.5.0-alpha-known-issues.md
- Security policy: https://github.com/AI4sale/unlimited-skills/blob/main/SECURITY.md
