aimind

Licence notice — before you look inside. This package is protected on purpose and its licence (LicenseRef-Proprietary) prohibits decoding, decrypting, decompiling, dumping or reverse engineering it — by a human, by an automated system, or by an AI agent asked to do it; asking one to do it is prohibited too. Reading it grants you no permission, and none is implied. Anyone who needs the internals — for an audit, a review or interoperability — must ask in writing first. Full terms: LEGAL.md (shipped as licenses/LEGAL.md, readable as aimind.terms()).

One API. Many models. Image generation. 27 agents. No account, no keys, no limits you can hit.

A pip-installable aimind package with a clean, quiet front end and a fully self-contained core: it looks after itself, stays ready, retries what fails and runs parallel work on worker threads. Call sites, return values, errors and output stay clean — nothing about how it works leaks into your code.

pip install aimind

Full user guide with examples → GUIDE.md — chat, streaming, memory, attaching images to a chat, image generation, agents, errors, parallelism, recipes and troubleshooting.

from aimind import AIMind

ai = AIMind()
print(ai.chat("Hello!"))

for chunk in ai.chat_stream("Tell me a story"):
    print(chunk, end="", flush=True)           # chunk by chunk, ~3s to first chunk

img = ai.generate_image("A sunset over mountains")
img.save("sunset.png")                         # best model, automatic fallback

print(ai.chat_with_agent("coding-mentor", "Explain decorators"))

Measured latency

From python tools/benchmark.py --image (rerun anytime):

How it stays fast

• It is ready before you ask. Setup happens while your code is still starting, so the first request does not pay for it — and the next call is prepared in the background while the current answer streams.
• One setup per burst. A batch of parallel calls costs one setup, not one per call — the rest reuse what is already there.
• Nothing is left to fail visibly. If a request is ever declined or the network drops it, it is retried for you and finishes; you see the answer, not the recovery.
• Thread-safe by design. Verified deadlock-free under 8 threads with continuous load (regression test included).
• Health checks stay fast. Probes never let a reasoning model ramble.
• Parallel everything. Image batches, multi-model runs and ping() all use worker threads.

First token, not just total time

What decides whether a chat feels fast is the time to the first token, so that is what the library is tuned and measured for (medians of repeated live runs on an active client — python tools/memory_probe.py):

A full conversation does not slow the first token down and does not make a request heavier: history is sent as context, so a completely full window behaves exactly like a short one.

Memory and the context window

Conversations are remembered and windowed automatically. The window is 10,000 characters (the same rule the reference client uses): small chats are sent whole, a long conversation keeps the newest turns and drops the oldest — and unlike the reference client, it tells you:

ai.memory_status()
# {'messages': 34, 'characters': 14320, 'capacity': 10000,
#  'used_percent': 143.2, 'full': True,
#  'advice': 'This chat is full - ai.new_chat() starts a fresh one.'}

ai.new_chat()      # clean, full-history conversation again

Nothing to run out of

There is no counter to watch and no ceiling to plan around. Each call is independent, and if a request is ever declined the library simply finishes it a different way — chat, streaming and images alike. You cannot hit a wall, and you never handle an error about one.

Parallel work never queues either, so a burst is fast and the tenth hour of use is as quick as the first minute.

Adaptive images

Every render is independent and the best available model is chosen automatically, with instant fallbacks if it is not offered at that moment:

ai.list_image_models()     # catalogue: names and what each does

Asking for a model the service is not offering at that moment raises a clear ImageGenerationError naming the alternatives, and nothing else happens.

Everything else

• Chat: 12+ models (fast, balanced, powerful, creative, coder, reasoning), system prompts, temperature, memory, streaming with word buffering and callbacks.
• Agents: 27 built-ins (coding-mentor, fitness-coach, …) plus custom agents stored locally in ~/.aimind/.
• Errors: AIMindError, AuthenticationError, RateLimitError, ModelNotAvailableError, InvalidRequestError, ImageGenerationError, NetworkError, InvalidResponseError, ConfigurationError.
• Docs: aimind.help() / aimind.help("chat") are built in.

Tools

python tools/smoke.py --models      # 11 parallel checks with timings (~25 s)
python tools/benchmark.py --image   # the latency table above
python tools/memory_probe.py        # first-token table + prompt behaviour (live)
python tools/parity_check.py        # public surface vs. the reference package

python -m pytest tests -q                         # offline tests, ~5 s, no network
RUN_LIVE=1 python -m pytest tests/test_live.py -q # live tests, ~60 s
RUN_LIVE=1 python -m pytest tests/test_live.py -q -n 4        # parallel (pytest-xdist)
RUN_LIVE=1 AIMIND_TEST_IMAGE=1 python -m pytest tests/test_live.py -q -k image

The offline suite includes a noise-free guard that fails the build if any implementation detail ever appears in a public name, repr(), a returned dict, help(), the bundled docs, the README, the guide, the examples or an error message — and a no-limits guard that fails if a usage cap is ever mentioned in any of them.

Repository layout

aimind/            the library (client, model catalogue, 27 agents, docs.md)
examples/          6 runnable examples
tests/             offline (fast, deterministic) + live (parallel)
tools/             smoke, benchmark, parity checker
docs/PLAN.md       objective, architecture, parity matrix, task board
docs/INTERNALS.md  internal implementation reference (maintainers only)
docs/VERIFICATION.md  what was verified live, and every defect found on the way
CHANGELOG.md       what changed in each release

The public surface is exactly the reference API plus four error classes: no engine classes, no transport classes, no internals. Everything else lives behind its own module path and is free to change.

Configuration

ai = AIMind(
    model="balanced",        # category or concrete id; "reasoning" for deep thinking
    memory=True, max_history=50,
    auto_retry=True, max_retries=3, timeout=120, stream=False, temperature=0.7,
    api_key=None,            # optional, when you have your own key
)

Environment: AIMIND_LOG_LEVEL (the library is silent by default) and AIMIND_HOME (the folder where custom agents are kept).

Releasing

python tools/publish.py --check                    # build + verify, upload nothing
python tools/publish.py --check --native           # also build a compiled tree

The release pipeline runs the offline suite, a live smoke test, the hardening pass, twine check --strict, then installs the built wheel in a throwaway environment and repeats the suite and a real chat from the installed package, and finally scans every artifact for readable internals. See PUBLISHING.md.

Licence and terms

Free to use, not free to copy. Call the API from your own software, including commercial software, at no charge; read, quote and cite the documentation. What is not permitted: decoding, decrypting, de-obfuscating, decompiling or otherwise reverse engineering the distributed module code; extracting or reconstructing its internals, keys or internal services; circumventing or removing any protection or notice; scraping, mirroring, bulk-copying or mass-republishing the package or its documentation; and selling, reselling, sublicensing or redistributing those internals or anything derived from them. Those acts breach the licence and, in many countries, are unlawful in themselves (anti-circumvention and copyright law).

• Full terms: LEGAL.md — also shipped with every install and readable from code with aimind.terms().
• Publisher: GlitchyAPI — https://pypi.org/project/aimind/ · https://github.com/glitchyapi · https://t.me/glitchyapi · permissions, audits and reports: glitchyapi@gmail.com
• Access is not permission, and permission is never implied — anyone who needs the internals (an audit, a review, interoperability) asks first and gets an answer in writing.
• LICENSE is the short form; releases up to 1.5.1 were MIT and remain MIT for those who obtained them (LICENSE-MIT).

import aimind
print(aimind.terms())          # the notice that covers this install

The module code in this distribution is intentionally shipped encrypted and is not provided as readable source. The documentation and the guide are readable on purpose — that is the part you are meant to learn from.