forgegrit-cli 1.0.0__py3-none-any.whl

forgegrit_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

forgegrit_cli/__main__.py

@@ -0,0 +1,3 @@
+from .main import main
+
+main()

forgegrit_cli/main.py

@@ -0,0 +1,408 @@
+"""ForgeGrit CLI — talk to the ForgeGrit API from a terminal.
+
+Auth (pick one):
+  forgegrit login       log in with your ForgeGrit email + password
+  forgegrit register    create a new ForgeGrit account
+  forgegrit api KEY     use an API key you already have
+
+Then:
+  forgegrit chat        interactive chat (streams replies)
+  forgegrit ask "..."   one question, one answer
+  forgegrit models      list models
+  forgegrit usage       requests used today
+  forgegrit whoami      show the saved login
+  forgegrit logout      forget the saved key
+"""
+
+import argparse
+import getpass
+import json
+import os
+import stat
+import sys
+
+import requests
+
+from . import __version__
+
+DEFAULT_URL = "https://api-forgegrit.serveousercontent.com"
+DEFAULT_MODEL = "claude-opus-5"
+CONFIG_DIR = os.path.join(os.path.expanduser("~"), ".forgegrit")
+CONFIG_FILE = os.path.join(CONFIG_DIR, "config.json")
+TIMEOUT = 300
+
+# ---------------------------------------------------------------- terminal colours
+_COLOR = sys.stdout.isatty() and os.environ.get("NO_COLOR") is None
+
+
+def _c(code, text):
+    return f"\033[{code}m{text}\033[0m" if _COLOR else text
+
+
+def orange(t): return _c("38;5;208", t)
+def green(t): return _c("32", t)
+def red(t): return _c("31", t)
+def dim(t): return _c("2", t)
+def bold(t): return _c("1", t)
+
+
+def die(msg, code=1):
+    print(red("error: ") + msg, file=sys.stderr)
+    sys.exit(code)
+
+
+# ---------------------------------------------------------------- config
+def load_config():
+    try:
+        with open(CONFIG_FILE, encoding="utf-8") as f:
+            return json.load(f)
+    except (OSError, ValueError):
+        return {}
+
+
+def save_config(cfg):
+    os.makedirs(CONFIG_DIR, exist_ok=True)
+    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(cfg, f, indent=2)
+    try:  # the file holds an API key — keep it private
+        os.chmod(CONFIG_FILE, stat.S_IRUSR | stat.S_IWUSR)
+    except OSError:
+        pass
+
+
+def base_url(args, cfg):
+    return (getattr(args, "url", None) or os.environ.get("FORGEGRIT_URL")
+            or cfg.get("url") or DEFAULT_URL).rstrip("/")
+
+
+def api_key(cfg):
+    key = os.environ.get("FORGEGRIT_API_KEY") or cfg.get("api_key")
+    if not key:
+        die("not logged in. Run `forgegrit login`, `forgegrit register`, "
+            "or `forgegrit api YOUR_KEY` first.")
+    return key
+
+
+def mask(key):
+    return key[:8] + "…" + key[-4:] if key and len(key) > 14 else "(none)"
+
+
+# ---------------------------------------------------------------- HTTP
+def request(method, url, **kw):
+    kw.setdefault("timeout", TIMEOUT)
+    try:
+        r = requests.request(method, url, **kw)
+    except requests.ConnectionError:
+        die(f"can't reach {url.split('/v1')[0].split('/auth')[0]}. "
+            "The server or its tunnel may be offline.")
+    except requests.Timeout:
+        die("the server took too long to answer.")
+    return r
+
+
+def body_of(r):
+    try:
+        return r.json()
+    except ValueError:
+        if r.status_code == 502 and not r.text.strip():
+            die("the tunnel returned an empty 502 — usually a brief hiccup. Try again.")
+        die(f"unexpected response (HTTP {r.status_code}): {r.text[:200]}")
+
+
+def explain(r, data, auth=False):
+    msg = data.get("error") or f"HTTP {r.status_code}"
+    if auth:  # login/register: a 401 means bad credentials, not a bad key
+        die(msg + (f"\n  {data['how']}" if data.get("how") else ""))
+    hint = {
+        401: "Your key was rejected. Log in again or run `forgegrit api NEW_KEY`.",
+        403: None,
+        429: "Daily limit reached. It resets at midnight.",
+        502: "The model backend is down. Try again shortly.",
+    }.get(r.status_code)
+    if data.get("how"):
+        hint = data["how"]
+    die(msg + (f"\n  {hint}" if hint else ""))
+
+
+def show_notice(data):
+    if data.get("notice"):
+        print(dim("note: " + data["notice"]))
+
+
+def prompt_credentials():
+    email = input("Email: ").strip()
+    password = getpass.getpass("Password: ")
+    if not email or not password:
+        die("email and password are both required.")
+    return email, password
+
+
+# ---------------------------------------------------------------- auth commands
+def cmd_login(args):
+    cfg = load_config()
+    url = base_url(args, cfg)
+    email, password = (args.email, args.password) if args.email and args.password \
+        else prompt_credentials()
+    payload = {"email": email, "password": password}
+
+    for _ in range(3):
+        r = request("POST", f"{url}/authenticate/email", json=payload)
+        data = body_of(r)
+        if r.ok:
+            break
+        if data.get("requires_2fa"):
+            if data.get("code_reused"):
+                print(dim("That code was already used — wait for the next one."))
+            payload["code"] = input("2FA code: ").strip()
+            continue
+        explain(r, data, auth=True)
+    else:
+        die("too many failed 2FA attempts.")
+
+    cfg.update(api_key=data["api_key"], email=email, url=url, method="login")
+    save_config(cfg)
+    print(green("✓ Logged in") + f" as {bold(email)}")
+    print(dim(f"  key {mask(data['api_key'])} saved to {CONFIG_FILE}"))
+    show_notice(data)
+
+
+def cmd_register(args):
+    cfg = load_config()
+    url = base_url(args, cfg)
+    email, password = (args.email, args.password) if args.email and args.password \
+        else prompt_credentials()
+    if not (args.email and args.password):
+        if getpass.getpass("Confirm password: ") != password:
+            die("passwords don't match.")
+
+    r = request("POST", f"{url}/register", json={"email": email, "password": password})
+    data = body_of(r)
+    if not r.ok:
+        explain(r, data, auth=True)
+    print(green("✓ Account created") + f" for {bold(email)}")
+    show_notice(data)
+
+    # log straight in so the user can chat immediately
+    r = request("POST", f"{url}/authenticate/email",
+                json={"email": email, "password": password})
+    data = body_of(r)
+    if not r.ok:
+        explain(r, data)
+    cfg.update(api_key=data["api_key"], email=email, url=url, method="register")
+    save_config(cfg)
+    print(dim(f"  key {mask(data['api_key'])} saved to {CONFIG_FILE}"))
+
+
+def cmd_api(args):
+    cfg = load_config()
+    url = base_url(args, cfg)
+    key = args.key or getpass.getpass("API key: ").strip()
+    if not key:
+        die("no key given.")
+    r = request("GET", f"{url}/v1/models", headers={"Authorization": f"Bearer {key}"})
+    data = body_of(r)
+    if not r.ok:
+        explain(r, data)
+    cfg.update(api_key=key, url=url, method="api")
+    cfg.pop("email", None)
+    save_config(cfg)
+    print(green("✓ API key saved") + dim(f"  ({mask(key)}, {len(data.get('data', []))} models available)"))
+
+
+def cmd_logout(args):
+    cfg = load_config()
+    for k in ("api_key", "email", "method"):
+        cfg.pop(k, None)
+    save_config(cfg)
+    print("Logged out. Your key is still valid on the server — rotate it on the site if it leaked.")
+
+
+def cmd_whoami(args):
+    cfg = load_config()
+    key = os.environ.get("FORGEGRIT_API_KEY") or cfg.get("api_key")
+    print(f"server : {base_url(args, cfg)}")
+    print(f"account: {cfg.get('email') or dim('(API key only)')}")
+    print(f"method : {cfg.get('method', '—')}")
+    print(f"key    : {mask(key)}")
+    print(f"model  : {cfg.get('model', DEFAULT_MODEL)}")
+
+
+# ---------------------------------------------------------------- info commands
+def cmd_models(args):
+    cfg = load_config()
+    r = request("GET", f"{base_url(args, cfg)}/v1/models",
+                headers={"Authorization": f"Bearer {api_key(cfg)}"})
+    data = body_of(r)
+    if not r.ok:
+        explain(r, data)
+    current = cfg.get("model", DEFAULT_MODEL)
+    for m in sorted(data.get("data", []), key=lambda m: m["id"]):
+        mark = green("●") if m["id"] == current else " "
+        print(f" {mark} {m['id']}")
+    print(dim(f"\n{len(data.get('data', []))} models · default: {current} "
+              "· change with `forgegrit model ID`"))
+
+
+def cmd_model(args):
+    cfg = load_config()
+    cfg["model"] = args.id
+    save_config(cfg)
+    print(green("✓ Default model: ") + args.id)
+
+
+def cmd_usage(args):
+    cfg = load_config()
+    r = request("GET", f"{base_url(args, cfg)}/v1/usage",
+                headers={"Authorization": f"Bearer {api_key(cfg)}"})
+    data = body_of(r)
+    if not r.ok:
+        explain(r, data)
+    used, limit = data.get("requests_today", 0), data.get("rpd_limit", 0)
+    print(f"{used:,} / {limit:,} requests today  ·  {data.get('remaining', 0):,} left")
+
+
+# ---------------------------------------------------------------- chat
+def stream_reply(url, key, model, messages):
+    """Send a chat request with streaming on; print tokens as they arrive.
+    Returns the full reply text."""
+    r = request("POST", f"{url}/v1/chat/completions",
+                headers={"Authorization": f"Bearer {key}"},
+                json={"model": model, "messages": messages, "stream": True},
+                stream=True)
+    if not r.ok:
+        explain(r, body_of(r))
+
+    out = []
+    for raw in r.iter_lines(decode_unicode=True):
+        if not raw or not raw.startswith("data:"):
+            continue
+        chunk = raw[5:].strip()
+        if chunk == "[DONE]":
+            break
+        try:
+            piece = json.loads(chunk)["choices"][0].get("delta", {}).get("content") or ""
+        except (ValueError, KeyError, IndexError):
+            continue
+        out.append(piece)
+        sys.stdout.write(piece)
+        sys.stdout.flush()
+    print()
+    return "".join(out)
+
+
+def cmd_ask(args):
+    cfg = load_config()
+    prompt = " ".join(args.prompt) if args.prompt else sys.stdin.read()
+    if not prompt.strip():
+        die("nothing to ask.")
+    msgs = []
+    if args.system:
+        msgs.append({"role": "system", "content": args.system})
+    msgs.append({"role": "user", "content": prompt})
+    stream_reply(base_url(args, cfg), api_key(cfg),
+                 args.model or cfg.get("model", DEFAULT_MODEL), msgs)
+
+
+CHAT_HELP = """commands:
+  /model ID    switch model
+  /system TEXT set a system prompt (clears history)
+  /clear       start a new conversation
+  /exit        quit (or Ctrl+D)"""
+
+
+def cmd_chat(args):
+    cfg = load_config()
+    url, key = base_url(args, cfg), api_key(cfg)
+    model = args.model or cfg.get("model", DEFAULT_MODEL)
+    system = args.system
+    history = []
+
+    print(orange("⚡ ForgeGrit") + dim(f"  ·  {model}  ·  /help for commands"))
+    while True:
+        try:
+            line = input(bold("you › "))
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return
+        text = line.strip()
+        if not text:
+            continue
+        if text in ("/exit", "/quit"):
+            return
+        if text == "/help":
+            print(dim(CHAT_HELP)); continue
+        if text == "/clear":
+            history = []; print(dim("(new conversation)")); continue
+        if text.startswith("/model"):
+            parts = text.split(maxsplit=1)
+            if len(parts) == 2:
+                model = parts[1]; print(dim(f"(model: {model})"))
+            else:
+                print(dim(f"(model: {model})"))
+            continue
+        if text.startswith("/system"):
+            system = text[7:].strip() or None
+            history = []
+            print(dim("(system prompt set, history cleared)" if system else "(system prompt cleared)"))
+            continue
+
+        history.append({"role": "user", "content": text})
+        msgs = ([{"role": "system", "content": system}] if system else []) + history
+        sys.stdout.write(orange(f"{model} › "))
+        sys.stdout.flush()
+        try:
+            reply = stream_reply(url, key, model, msgs)
+        except KeyboardInterrupt:
+            print(dim("\n(stopped)"))
+            history.pop()
+            continue
+        history.append({"role": "assistant", "content": reply})
+
+
+# ---------------------------------------------------------------- entry point
+def main(argv=None):
+    p = argparse.ArgumentParser(
+        prog="forgegrit",
+        description="ForgeGrit CLI — free frontier-model API from your terminal.",
+        epilog="Get an account at https://trey16885.github.io/forgegrit")
+    p.add_argument("--url", help=f"API base URL (default {DEFAULT_URL}, or $FORGEGRIT_URL)")
+    p.add_argument("-V", "--version", action="version", version=f"forgegrit-cli {__version__}")
+    sub = p.add_subparsers(dest="cmd", metavar="COMMAND")
+
+    s = sub.add_parser("login", help="log in with your ForgeGrit email and password")
+    s.add_argument("--email"); s.add_argument("--password")
+    s.set_defaults(func=cmd_login)
+
+    s = sub.add_parser("register", help="create a new ForgeGrit account")
+    s.add_argument("--email"); s.add_argument("--password")
+    s.set_defaults(func=cmd_register)
+
+    s = sub.add_parser("api", help="use an existing API key")
+    s.add_argument("key", nargs="?", help="your fgk_… key (prompted if omitted)")
+    s.set_defaults(func=cmd_api)
+
+    s = sub.add_parser("chat", help="interactive chat")
+    s.add_argument("-m", "--model"); s.add_argument("-s", "--system")
+    s.set_defaults(func=cmd_chat)
+
+    s = sub.add_parser("ask", help="ask one question (or pipe text in)")
+    s.add_argument("prompt", nargs="*")
+    s.add_argument("-m", "--model"); s.add_argument("-s", "--system")
+    s.set_defaults(func=cmd_ask)
+
+    s = sub.add_parser("models", help="list available models"); s.set_defaults(func=cmd_models)
+    s = sub.add_parser("model", help="set your default model")
+    s.add_argument("id"); s.set_defaults(func=cmd_model)
+    s = sub.add_parser("usage", help="requests used today"); s.set_defaults(func=cmd_usage)
+    s = sub.add_parser("whoami", help="show the saved login"); s.set_defaults(func=cmd_whoami)
+    s = sub.add_parser("logout", help="forget the saved key"); s.set_defaults(func=cmd_logout)
+
+    args = p.parse_args(argv)
+    if not getattr(args, "func", None):
+        p.print_help()
+        return
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

forgegrit_cli-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 treyleo16
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

forgegrit_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.1
+Name: forgegrit-cli
+Version: 1.0.0
+Summary: Command-line client for the ForgeGrit API: log in, register, and chat with every ForgeGrit model from your terminal.
+Author: treyleo16
+License: MIT
+Project-URL: Homepage, https://trey16885.github.io/forgegrit
+Keywords: forgegrit,llm,ai,cli,chat,api
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.20
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# ForgeGrit CLI
+
+Chat with every ForgeGrit model from your terminal. Free: no credit card, no trial credits.
+
+```bash
+pip install forgegrit-cli
+```
+
+## Sign in — pick one
+
+```bash
+forgegrit login              # use your ForgeGrit email + password (2FA supported)
+forgegrit register           # create a new ForgeGrit account
+forgegrit api fgk_yourkey    # use an API key you already have
+```
+
+Your key is saved to `~/.forgegrit/config.json`, readable only by you.
+
+## Use it
+
+```bash
+forgegrit chat                       # interactive chat, replies stream in
+forgegrit chat -m gpt-6-astra        # pick a model
+forgegrit ask "explain recursion"    # one-shot question
+cat notes.txt | forgegrit ask        # pipe text in
+forgegrit models                     # list models
+forgegrit model claude-sonnet-5-5    # set your default model
+forgegrit usage                      # requests used today
+forgegrit whoami                     # show the saved login
+forgegrit logout                     # forget the saved key
+```
+
+Inside `chat`: `/model ID`, `/system TEXT`, `/clear`, `/help`, `/exit`.
+
+## Settings
+
+| Variable | Does |
+|---|---|
+| `FORGEGRIT_API_KEY` | Use this key instead of the saved one |
+| `FORGEGRIT_URL` | Point at a different ForgeGrit server |
+| `NO_COLOR` | Turn off colours |
+
+## Note
+
+Chats sent through ForgeGrit are logged by the server with your account, the time, your IP address, the model, your messages and the reply.
+
+Get an account and read more at **https://trey16885.github.io/forgegrit**

forgegrit_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+forgegrit_cli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+forgegrit_cli/__main__.py,sha256=vBQ82334kX06ImDbFlPFgiBRiLIinwNk3z8Khs6hd74,31
+forgegrit_cli/main.py,sha256=1wdLD6dGiPN4neEQByHHxwR0CO_M_AA44PKwFgzOd5I,14032
+forgegrit_cli-1.0.0.dist-info/METADATA,sha256=tdKzjavky22s2OvxGxC01AuzprYstyqqBHBfiUzvs1U,2130
+forgegrit_cli-1.0.0.dist-info/WHEEL,sha256=yp6aTco6OR3LM3n7UjmqeZ-4FXtQoVHarWCrFD1CyGU,87
+forgegrit_cli-1.0.0.dist-info/entry_points.txt,sha256=jJyJqMYJ09tiee4e4LSgZK6oxUQDE7Mi8zvzMncJOqI,54
+forgegrit_cli-1.0.0.dist-info/top_level.txt,sha256=9k0302y9bxuLzWIMOpgF0wxhq2ZEMp0eiQBVaVTusjM,14
+forgegrit_cli-1.0.0.dist-info/LICENSE,sha256=bhsq1yPHxHBjccjl5zSTiNYwJN-har17OCw6DwKzJHw,1066
+forgegrit_cli-1.0.0.dist-info/RECORD,,

forgegrit_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: forgegrit-build
+Root-Is-Purelib: true
+Tag: py3-none-any
+

forgegrit_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+forgegrit = forgegrit_cli.main:main

forgegrit_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+forgegrit_cli