Skip to main content

MyText: A Minimal AI-Powered Text Rewriting Tool

Project description

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

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

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

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"])

Supported Providers

MyText automatically detects which providers are available based on environment variables:

Provider Required Environment Variables Main Model Fallback Model
AI Studio AI_STUDIO_API_KEY gemini-2.5-flash gemma-3-1b-it
Cloudflare CLOUDFLARE_API_KEY, CLOUDFLARE_ACCOUNT_ID meta/llama-3-8b-instruct meta/llama-3.1-8b-instruct-fast
OpenRouter OPENROUTER_API_KEY mistralai/mistral-small-3.1-24b-instruct:free google/gemma-3-27b-it:free
Cerebras CEREBRAS_API_KEY gpt-oss-120b llama-3.3-70b
Groq GROQ_API_KEY openai/gpt-oss-20b llama-3.1-8b-instant
NVIDIA NVIDIA_API_KEY meta/llama-3.1-8b-instruct meta/llama3-8b-instruct

Set them before using:

export AI_STUDIO_API_KEY="your-key"
export CLOUDFLARE_API_KEY="your-key"
export CLOUDFLARE_ACCOUNT_ID="your-account-id"
export OPENROUTER_API_KEY="your-key"
export CEREBRAS_API_KEY="your-key"
export GROQ_API_KEY="your-key"
export NVIDIA_API_KEY="your-key"

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

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.4 - 2025-12-25

Added

  • Groq provider
  • NVIDIA provider
  • --loop argument

Changed

  • Test system modified
  • README.md updated

0.3 - 2025-12-17

Added

  • OpenRouter provider
  • Cerebras provider

Changed

  • Test system modified
  • README.md updated
  • AI Studio main model changed to gemini-2.5-flash
  • AI Studio fallback model changed to gemma-3-1b-it
  • Providers moved to providers.py

0.2 - 2025-12-05

Added

  • Logo
  • summarize mode
  • simplify mode
  • bulletize mode
  • shorten mode

Changed

  • README.md updated
  • Cloudflare fallback model changed to meta/llama-3.1-8b-instruct-fast
  • Model switching modified

0.1 - 2025-11-26

Added

  • run_mytext function
  • AI Studio provider
  • Cloudflare provider
  • --mode argument
  • --tone argument

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mytext-0.4.tar.gz (16.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mytext-0.4-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file mytext-0.4.tar.gz.

File metadata

  • Download URL: mytext-0.4.tar.gz
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mytext-0.4.tar.gz
Algorithm Hash digest
SHA256 18a0e3dd8ee8ca96b5c33250347aa77bfe7dd04dbabf7d35f4e23f1e042f6ffb
MD5 1294d7536c9324671783641577aed9d9
BLAKE2b-256 24d7e4535c575b83c95d885107d845e8083de9a9d2bffde4474e2ac84edb31e1

See more details on using hashes here.

File details

Details for the file mytext-0.4-py3-none-any.whl.

File metadata

  • Download URL: mytext-0.4-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mytext-0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 201cd3e56159879e64ec471a6d5c13ba150699b9f6d589450c2545eff4c98a24
MD5 d04b4d04902a28538c22d8004108f2e6
BLAKE2b-256 e62afa9733123af98d250322ee3d65ddc80eb48b02df45da5563a8ea481f0cf6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page