Skip to main content

Advanced AI text humanization with context-aware processing, personality injection, and sophisticated NLP transformations.

Project description

Humano - Advanced AI Text Humanization

A sophisticated Python package for transforming AI-generated text into natural, human-like content using advanced NLP techniques and context-aware processing.

Features

  • Context-Aware Processing: Automatically detects and adapts to academic, business, technical, or casual content types
  • Multi-Phase Humanization: Core transformations → Structural improvements → Advanced techniques
  • Personality Injection: Choose from casual, confident, analytical, or balanced writing styles
  • Sophisticated Pattern Recognition: Targets specific AI-generated patterns and phrases
  • Natural Flow Enhancement: Creates sentence rhythm variation and natural imperfections
  • Smart Contractions: Context-sensitive application based on formality level
  • Semantic Intelligence: Uses clustering for intelligent word replacements

Installation

pip install humano

Quick Start

Python API

import humano

# Basic usage
result = humano.humanize("Your AI-generated text here", strength="medium")
print(result['humanized_content'])

# Advanced usage with personality
result = humano.humanize(
    "Your AI-generated text here", 
    strength="high",
    personality="casual"
)

# Check detailed results
if result['success']:
    print(f"Humanized: {result['humanized_content']}")
    print(f"Context detected: {result['context_detected']}")
    print(f"Transformations applied: {result['transformations_applied']}")
else:
    print(f"Error: {result['error']}")

Command Line

# Basic usage
humano "Your AI-generated text here"

# Advanced options
humano "Your text" --strength high --personality confident

# From file with custom settings
humano input.txt -o output.txt --strength medium --personality analytical

API Reference

humanize(content, strength="medium", personality="balanced")

Parameters:

  • content (str): Text to humanize (minimum 20 characters)
  • strength (str): Humanization intensity
    • "low": Core transformations only (pattern removal, word replacement, contractions)
    • "medium": + Sentence restructuring, personality injection, flow enhancement
    • "high": + Semantic enhancement, advanced burstiness, natural imperfections
  • personality (str): Writing style to inject
    • "balanced": Mix of all personality types (default)
    • "casual": Informal, conversational tone
    • "confident": Assertive, direct communication
    • "analytical": Thoughtful, measured approach

Returns:

{
    "success": bool,
    "humanized_content": str,      # If successful
    "context_detected": dict,      # Content analysis results
    "transformations_applied": int,# Number of changes made
    "message": str,               # Status message
    "error": str                  # If failed
}

How It Works

1. Context Analysis

Humano analyzes your text to detect:

  • Content Type: Academic, business, technical, or general
  • Formality Level: Determines transformation intensity
  • Writing Patterns: Identifies AI-generated structures

2. Multi-Phase Processing

Phase 1: Core Transformations (All Levels)

  • Pattern Removal: Targets AI phrases like "Furthermore," "In conclusion"
  • Contextual Word Replacement: Swaps formal terms for natural alternatives
  • Smart Contractions: Applies contractions based on context formality

Phase 2: Structural Improvements (Medium+)

  • Sentence Restructuring: Transforms rigid sentence patterns
  • Personality Injection: Adds human-like communication styles
  • Flow Enhancement: Creates natural rhythm and connectivity

Phase 3: Advanced Techniques (High Only)

  • Semantic Enhancement: Intelligent phrase replacements
  • Burstiness Control: Varies sentence lengths naturally
  • Natural Imperfections: Adds subtle human-like hesitations
  • Contextual Emphasis: Strategic word emphasis

Troubleshooting

Common Issues

  • Minimum Text Length: Text must be at least 20 characters
  • Memory Usage: Large texts may require more memory for processing
  • Randomization: Results may vary slightly between runs due to probabilistic transformations

Examples

Academic Text Transformation

Input:

Furthermore, it is important to note that the methodology utilized in this research demonstrates significant advantages. The implementation of these techniques facilitates comprehensive analysis and subsequently yields substantial improvements in overall performance metrics.

Output (High Strength, Casual Personality):

Plus, here's the thing - the method we used in this research shows some real benefits. Using these techniques helps us do thorough analysis and ends up giving us major improvements in how well everything performs.

Business Content Humanization

Input:

We must leverage our core competencies to optimize synergies and streamline operational paradigms. This strategic approach will facilitate scalable solutions and maximize actionable insights across all stakeholder touchpoints.

Output (Medium Strength, Confident Personality):

Look, we need to use our strengths to improve how different parts work together and simplify our operations. This approach will help us create flexible solutions and get the most useful insights for everyone involved.

License

MIT License - see LICENSE file for details.

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

humano-2.0.1.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

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

humano-2.0.1-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file humano-2.0.1.tar.gz.

File metadata

  • Download URL: humano-2.0.1.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for humano-2.0.1.tar.gz
Algorithm Hash digest
SHA256 898d1e2c097c3e10c5c43ad2e021394f7138c1cdcee4c7d6cfabb0f74f708387
MD5 3df07ddf2dcbc8b8855979b3dbf35d93
BLAKE2b-256 46da24f9d869c257027db2966b8d0fd521025986070b755b07bfbb320be7801e

See more details on using hashes here.

File details

Details for the file humano-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: humano-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for humano-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bc557fcc0b1ab290823d0cd82a2aa4a3fd428ddefb9506680185d16911af85e6
MD5 1f870568eb811e1439e216f7fef2b604
BLAKE2b-256 569f5aef86285c136120c0bbd7754b1b40d172cc2d5d26c0cd2000ee222da128

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