Skip to content
kevin0818-lxdPublic

About

Humanize AI-text to bypass turnitin and improve language diversity.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Humanizer

Humanizer is a local-first rewrite workspace for long English text. It splits text into semantic chunks, generates left_skew, middle_skew, and right_skew alternatives, and lets you assemble a cleaner final draft chunk by chunk.

This public repository now exposes one unique runnable baseline so users do not have to guess which model stack was actually used.

Public Baseline

  • Base model: TinyLlama/TinyLlama-1.1B-Chat-v1.0
  • Adapter version: humanizer-tinyllama-v6-step-0040
  • Adapter download location: GitHub Release asset on kevin0818-lxd/Humanizer
  • Model server: mistralrs OpenAI-compatible HTTP
  • Expected model port: 8081
  • Expected app API port: 8000

Download

1. Clone the repository

git clone https://github.com/kevin0818-lxd/Humanizer.git
cd Humanizer

2. Download the base model

Download the Hugging Face base model into:

data/models/tinyllama-1.1b-chat-v1.0

Recommended source:

TinyLlama/TinyLlama-1.1B-Chat-v1.0

Example:

huggingface-cli download TinyLlama/TinyLlama-1.1B-Chat-v1.0 \
  --local-dir data/models/tinyllama-1.1b-chat-v1.0

3. Download the adapter release asset

Download the release asset:

humanizer-tinyllama-v6-step-0040.zip

Unzip it so the adapter directory becomes:

data/models/humanizer-tinyllama-v6-step-0040

After unzip, that folder should contain:

  • adapter_model.safetensors
  • adapter_config.json
  • metrics.json
  • manifest.json
  • README.md

Install

cp .env.example .env
uv sync --directory apps/api --extra dev
npm --prefix apps/web install

Start Command

1. Start the model server

mistralrs serve \
  -m data/models/tinyllama-1.1b-chat-v1.0 \
  --lora data/models/humanizer-tinyllama-v6-step-0040 \
  --max-seq-len 4096 \
  --max-batch-size 1 \
  --host 0.0.0.0 \
  --port 8081 \
  --no-ui

2. Start the app API

uv run --directory apps/api uvicorn app.main:app --host 127.0.0.1 --port 8000

3. Start the web app

npm --prefix apps/web run dev

Expected Ports

  • Model server: http://127.0.0.1:8081
  • App API: http://127.0.0.1:8000
  • Web UI: http://127.0.0.1:3000

Minimal Acceptance Check

1. Check the app API

curl http://127.0.0.1:8000/health

Expected:

{"status":"ok","mode":"http"}

2. Check the model server

curl http://127.0.0.1:8081/v1/models

Expected:

  • one loaded local model
  • model id default

3. Open the UI

Open:

http://127.0.0.1:3000

Paste a paragraph, generate candidates, and confirm that the app returns real left_skew, middle_skew, and right_skew outputs instead of mock text.

Project Layout

  • apps/api: FastAPI backend
  • apps/web: Next.js frontend
  • scripts: dataset, training, evaluation, and probing utilities
  • docs: dataset and training design notes
  • configs: local experiment configs

Public Repo Policy

This repository intentionally does not include:

  • .env files or private credentials
  • local databases and runtime logs
  • uploaded source files and derived datasets
  • downloaded models, adapters, or checkpoints in Git history
  • local evaluation artifacts and caches
  • machine-specific workspace files

The runnable adapter is published as a GitHub Release asset, not in the main repository history.

About

Humanize AI-text to bypass turnitin and improve language diversity.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages