Skip to content

sepandhaghighi/mytext

MyText: A Minimal AI-Powered Text Rewriting Tool


built with Python3 GitHub repo size PyPI version

Overview

MyText is a lightweight AI-powered text enhancement tool that rewrites, paraphrases, and adjusts tone using modern LLM providers. It offers a clean command-line interface and a minimal Python API, supports multiple providers (Google AI Studio & Cloudflare Workers AI), and automatically selects the first available provider based on your environment variables.

PyPI Counter
Github Stars
Branch main dev
CI
Code Quality CodeFactor

Installation

Source Code

PyPI

Usage

CLI

Single Run

Executes a one-time text transformation using the provided options and exits immediately after producing the result.

mytext \
  --mode="paraphrase" \
  --tone="formal" \
  --text="Can you update me on the project timeline by the end of the day?"

Loop

Starts an interactive session that repeatedly accepts new text inputs from the user while keeping the same configuration until the process is terminated.

mytext \
  --mode="paraphrase" \
  --tone="formal" \
  --loop

Arguments

Argument Description Default
--text Text to process (required unless --loop is used) -
--mode Text processing mode paraphrase
--tone Output text desired tone neutral
--provider AI provider selection auto
--loop Enable interactive loop mode false
--model Override provider LLM model -
--version Show application version -
--info Show application information -

ℹ️ Supported modes: paraphrase, grammar, summarize, simplify, bulletize, shorten

ℹ️ Supported tones: neutral, formal, casual, friendly, professional, academic, creative

ℹ️ Supported providers: auto, ai-studio, cloudflare, openrouter, cerebras, groq, nvidia, github

Library

You can also use MyText directly inside Python.

from mytext import run_mytext
from mytext import Mode, Tone, Provider

auth = {"api_key": "YOUR_KEY"}
result = run_mytext(
    text="Let me know if you have any questions after reviewing the attached document.",
    auth=auth,
    mode=Mode.PARAPHRASE,
    tone=Tone.NEUTRAL,
    provider=Provider.AI_STUDIO
)

print(result["status"], result["message"])

Parameters

Parameter Description Default
text Input text to process -
auth Authentication parameters for the provider -
mode Text processing mode Mode.PARAPHRASE
tone Output text desired tone Tone.NEUTRAL
provider AI provider Provider.AI_STUDIO
model Override provider LLM model None

Supported Providers

MyText automatically detects which providers are available based on environment variables. Each provider has a default model. You may optionally override it using either the CLI --model argument or a *_MODEL environment variable.

Provider Required Environment Variables Default Model Optional Model Override
AI Studio AI_STUDIO_API_KEY gemma-3-1b-it AI_STUDIO_MODEL
Cloudflare CLOUDFLARE_API_KEY, CLOUDFLARE_ACCOUNT_ID meta/llama-3-8b-instruct CLOUDFLARE_MODEL
OpenRouter OPENROUTER_API_KEY openai/gpt-oss-20b:free OPENROUTER_MODEL
Cerebras CEREBRAS_API_KEY gpt-oss-120b CEREBRAS_MODEL
Groq GROQ_API_KEY openai/gpt-oss-20b GROQ_MODEL
NVIDIA NVIDIA_API_KEY meta/llama-3.1-8b-instruct NVIDIA_MODEL
GITHUB GITHUB_API_KEY openai/gpt-4o-mini GITHUB_MODEL

Configuration Resolution Priority

MyText supports multiple configuration sources (CLI arguments, environment variables, and built-in defaults). When resolving any configurable parameter (e.g., model), MyText follows this priority order:

  1. CLI argument (highest priority)
  2. Corresponding environment variable
  3. Built-in default value (lowest priority)

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

  • Please complete the issue template

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

Sponsor this project

Packages

 
 
 

Contributors

Languages