@mmmbuto/anthmorph 0.1.0

package/Cargo.toml

@@ -0,0 +1,61 @@
+[package]
+name = "AnthMorph"
+version = "0.1.0"
+edition = "2021"
+description = "Anthropic to OpenAI-compatible proxy"
+license = "MIT"
+repository = "https://github.com/DioNanos/AnthMorph"
+homepage = "https://github.com/DioNanos/AnthMorph"
+authors = ["DioNanos <noreply@github.com>"]
+
+[[bin]]
+name = "anthmorph"
+path = "src/main.rs"
+
+[dependencies]
+# Async runtime
+tokio = { version = "1.42", features = ["rt-multi-thread", "macros"] }
+
+# Web framework
+axum = { version = "0.7", features = ["http2"] }
+
+# HTTP client
+reqwest = { version = "0.12", features = ["json", "stream", "rustls-tls"], default-features = false }
+
+# Serialization
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+
+# Async utilities
+futures = "0.3"
+tokio-stream = "0.1"
+
+# Observability
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+# Error handling
+anyhow = "1.0"
+thiserror = "2.0"
+
+# Environment variables
+dotenvy = "0.15"
+
+# CLI argument parsing
+clap = { version = "4.5", features = ["derive"] }
+
+# Server utilities
+tower = { version = "0.5", features = ["util"] }
+tower-http = { version = "0.6", features = ["trace", "cors"] }
+
+# Async streams
+async-stream = "0.3"
+bytes = "1.9"
+pin-project = "1.1"
+
+[profile.release]
+opt-level = "z"
+lto = true
+codegen-units = 1
+strip = true
+panic = "abort"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DioNanos
+
+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.

package/README.md

@@ -0,0 +1,184 @@
+# AnthMorph
+
+[![Status](https://img.shields.io/badge/Status-0.1.0-blue.svg)](#project-status)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Rust](https://img.shields.io/badge/Rust-1.94%2B-orange.svg)](https://www.rust-lang.org)
+[![Target](https://img.shields.io/badge/Target-Termux%20%2F%20Linux-green.svg)](https://termux.dev)
+[![npm](https://img.shields.io/npm/v/@mmmbuto/anthmorph?style=flat-square&logo=npm)](https://www.npmjs.com/package/@mmmbuto/anthmorph)
+
+AnthMorph is a Chutes-first Anthropic `/v1/messages` proxy written in Rust.
+It lets Claude-style clients talk to Chutes or other OpenAI-compatible backends through a safer, profile-aware translation layer.
+
+Core capabilities:
+- Anthropic `/v1/messages` ingress with OpenAI-compatible upstream translation
+- `chutes` profile optimized for Chutes-specific compatibility, including `top_k` and reasoning handling
+- `openai_generic` profile for conservative compatibility with generic OpenAI-style providers
+- Streaming SSE translation with fragmented tool-call handling
+- Local control CLI for init, start, stop, restart, status, and logs
+- Termux-friendly workflow with optional npm distribution
+
+## Project Status
+
+- Current line: `0.1.0`
+- Primary target: `chutes.ai`
+- Secondary target: generic OpenAI-compatible endpoints
+- Tested locally against Chutes, MiniMax, and Alibaba Coding Plan rejection handling
+- Distribution paths: source build and npm package under `@mmmbuto/anthmorph`
+- Repository metadata is aligned for GitHub and npm publication
+
+## Quickstart
+
+1. Install
+
+Source build:
+
+```bash
+cargo build --release
+```
+
+Global npm install:
+
+```bash
+npm install -g @mmmbuto/anthmorph
+```
+
+2. Initialize Chutes profile
+
+```bash
+export CHUTES_API_KEY=your_key_here
+anthmorphctl init chutes --port 3107
+```
+
+3. Start proxy
+
+```bash
+anthmorphctl start
+anthmorphctl status
+```
+
+4. Stop proxy
+
+```bash
+anthmorphctl stop
+```
+
+## CLI Control
+
+`anthmorphctl` is the operator entrypoint.
+It stores runtime state under `.anthmorph/` in the project root.
+
+Common commands:
+
+```bash
+anthmorphctl init chutes
+anthmorphctl init minimax
+anthmorphctl init openai --backend-url https://api.example.com/v1 --model my-model --key-env EXAMPLE_API_KEY
+anthmorphctl start
+anthmorphctl status
+anthmorphctl logs
+anthmorphctl stop
+```
+
+Direct binary usage is also available:
+
+```bash
+anthmorph --port 3107 --backend-profile chutes --backend-url https://llm.chutes.ai/v1 --model Qwen/Qwen3-Coder-Next-TEE --api-key "$CHUTES_API_KEY"
+```
+
+## Architecture
+
+- `Ingress`: accepts Anthropic `/v1/messages` requests and validates profile-safe behavior.
+- `Transform`: converts Anthropic messages, tools, and stop reasons into OpenAI-compatible payloads.
+- `Streaming`: translates upstream SSE chunks back into Anthropic-style streaming events.
+- `Profiles`: selects `chutes` or `openai_generic` behavior for request and response handling.
+- `Control CLI`: manages local config, runtime state, start/stop/status, and operator logs.
+
+## API Key Policy
+
+Preferred mode:
+- Store only the environment variable name with `anthmorphctl set key-env ENV_NAME`
+- Keep the secret in your shell environment
+
+Optional mode:
+- Persist the key locally with `anthmorphctl set key VALUE --save`
+
+Recommendation:
+- Do not save API keys in the repo by default
+- Use env vars for daily operation and CI
+
+## Backend Profiles
+
+- `chutes`: optimized path for Chutes, including `top_k` pass-through and reasoning support
+- `openai_generic`: strips nonstandard fields and fails conservatively when the backend cannot represent Anthropic semantics safely
+
+## Safety Rules
+
+- Assistant thinking blocks in request history are rejected instead of being downgraded to plain text
+- Generic mode rejects backend reasoning content that cannot be represented safely
+- Streaming tool-call deltas support contiguous fragments and fail closed on unsafe interleaving
+- Optional ingress auth supports `Authorization: Bearer ...` or `x-api-key`
+- CORS is disabled unless explicitly configured
+
+## Real Backend Coverage
+
+Current integration coverage:
+- `chutes.ai`: positive end-to-end smoke test
+- `MiniMax`: positive end-to-end smoke test in generic mode
+- `Alibaba Coding Plan`: negative expected test documenting upstream rejection for generic chat-completions flow
+
+## npm Packaging
+
+This repository already includes npm packaging files:
+- `package.json`
+- `bin/anthmorph`
+- `scripts/postinstall.js`
+
+Packaging behavior:
+- `npm install -g @mmmbuto/anthmorph` exposes `anthmorph` and `anthmorphctl`
+- `postinstall` tries to build the Rust binary with `cargo build --release`
+- if the binary is missing later, the `anthmorph` shim will try to build it on demand
+
+## Build And Test
+
+```bash
+cargo test
+npm pack --dry-run
+```
+
+Real backend smoke tests:
+
+```bash
+./scripts/smoke_test.sh chutes
+./scripts/smoke_test.sh minimax
+./scripts/smoke_test.sh alibaba
+```
+
+## Repository Layout
+
+```text
+src/                  Rust proxy implementation
+bin/                  npm-exposed executable shims
+scripts/              control CLI, smoke tests, npm postinstall
+tests/                protocol and real-backend integration tests
+```
+
+## Documentation
+
+- Repository: https://github.com/DioNanos/AnthMorph
+- npm package: https://www.npmjs.com/package/@mmmbuto/anthmorph
+- Issue tracker: https://github.com/DioNanos/AnthMorph/issues
+
+## Roadmap
+
+1. Broader compatibility validation across more OpenAI-compatible providers
+2. End-to-end validation against real Claude-style clients
+3. Public-deployment hardening with rate limits and clearer auth policy
+4. Better streaming coverage for complex multi-tool interleaving
+
+## License
+
+MIT License
+<p>
+Copyright (c) 2026 DioNanos<br>
+Made in Italy
+</p>

package/bin/anthmorph

@@ -0,0 +1,22 @@
+#!/bin/sh
+set -eu
+
+ROOT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+RELEASE_BIN=$ROOT_DIR/target/release/anthmorph
+DEBUG_BIN=$ROOT_DIR/target/debug/anthmorph
+
+if [ -x "$RELEASE_BIN" ]; then
+  exec "$RELEASE_BIN" "$@"
+fi
+
+if [ -x "$DEBUG_BIN" ]; then
+  exec "$DEBUG_BIN" "$@"
+fi
+
+if command -v cargo >/dev/null 2>&1; then
+  (cd "$ROOT_DIR" && cargo build --release --quiet)
+  exec "$RELEASE_BIN" "$@"
+fi
+
+echo "anthmorph binary not found and cargo is unavailable" >&2
+exit 1

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@mmmbuto/anthmorph",
+  "version": "0.1.0",
+  "description": "Chutes-first Anthropic /v1/messages proxy for Chutes and OpenAI-compatible backends",
+  "license": "MIT",
+  "author": "DioNanos <noreply@github.com>",
+  "bin": {
+    "anthmorph": "bin/anthmorph",
+    "anthmorphctl": "scripts/anthmorphctl"
+  },
+  "files": [
+    "bin/",
+    "scripts/anthmorphctl",
+    "scripts/postinstall.js",
+    "scripts/smoke_test.sh",
+    "src/",
+    "tests/",
+    "Cargo.toml",
+    "Cargo.lock",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "build:rust": "cargo build --release",
+    "test": "cargo test",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "keywords": [
+    "anthropic",
+    "claude",
+    "proxy",
+    "chutes",
+    "openai-compatible",
+    "termux",
+    "rust"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DioNanos/AnthMorph.git"
+  },
+  "homepage": "https://github.com/DioNanos/AnthMorph#readme",
+  "bugs": {
+    "url": "https://github.com/DioNanos/AnthMorph/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}