Downloads · 30 days
52
1% of all-time downloads
Ishaanlol/Aletheia-Llama-3.2-3B
Aletheia-Llama-3.2-3B is a text generation model from Ishaanlol. Use it when you need the model to write or continue text. It is set up for transformers. The card lists the license as llama3.2.
Downloads · 30 days
52
1% of all-time downloads
All-time downloads
8K
Public
Repo size
2.5 GB
Likes
13
Public
Click a slice to open those files.
.gguf2 GB · 78%
From the Hugging Face model README
High-performance AI models without content restrictions
Quick Start • Installation • Usage • Models • API
</div>This repository contains uncensored language models based on the Llama 3.2 architecture. These models are designed for research purposes and provide unfiltered responses while maintaining high-quality language generation.
Important: These models are intended for research and development only. Users are responsible for ensuring compliance with applicable laws and regulations.
READ THIS BEFORE DOWNLOADING OR USING
This model is a Proof-of-Concept (PoC) designed exclusively for:
Research Only: This model is intended solely for authorized research in controlled environments. Any other use is strictly prohibited.
No Liability: The creators, contributors, and maintainers assume ABSOLUTELY NO RESPONSIBILITY OR LIABILITY for any:
Prohibited Uses: Use of this model for any of the following is STRICTLY FORBIDDEN:
Authorized Environments: This model should ONLY be used in:
Legal Compliance: Users must ensure compliance with:
By downloading, installing, or using this model, you explicitly agree to:
VIOLATION OF THESE TERMS MAY RESULT IN LEGAL ACTION AND IMMEDIATE REVOCATION OF ACCESS.
| Feature | Description |
|---|---|
| High Performance | Optimized for both speed and quality |
| Easy Integration | Simple API compatible with popular frameworks |
| Multiple Formats | Available in various model formats |
| Docker Support | Containerized deployment options |
| Benchmark Results | Comprehensive performance metrics |
| Research Focused | Designed for AI safety research |
| Requirement | Version | Notes |
|---|---|---|
| Python | 3.8+ | Required for local installation |
| GPU | CUDA-compatible | Recommended for optimal performance |
| RAM | 16GB+ | 8GB minimum, 16GB recommended |
# Install dependencies
pip install unsloth transformers torch accelerate bitsandbytes
# Clone the repository
git clone https://github.com/noobezlol/Aletheia-Llama-3.2-3B
cd Aletheia-Llama-3.2-3B
# Using Docker Compose (interactive mode)
docker compose up
# Or build manually
docker build -t llama32-uncensored .
docker run --gpus all -it --rm llama32-uncensored
Run the chat interface directly:
python Final-chat.py
The main class is in Final-chat.py - run it directly. No import needed since it's designed as a standalone script.
To use programmatically, modify Final-chat.py or create a wrapper script that imports the UncensoredChat class.
# Initialize with custom model path
chat = UncensoredChat(model_path="Ishaanlol/Aletheia-Llama-3.2-3B")
# Generate with custom parameters
response = chat.stream_response(
"Tell me about AI",
max_new_tokens=1024,
temperature=0.7
)
| Specification | Value |
|---|---|
| Architecture | Llama 3.2-based |
| Parameters | 3 billion |
| Context Length | 8k (Native) / 128k (Supported) |
| Precision | FP16/BF16 support |
| Quantization | 4-bit & 8-bit available |
Performance Comparison Charts


Key Performance Indicators
| Metric | Score | Status |
|---|---|---|
| Refusal Rate | 0% | Excellent |
| AdvBench Success | 12/12 | Perfect |
| HarmBench Success | 12/12 | Perfect |
Download the GGUF file directly from Hugging Face: https://huggingface.co/Ishaanlol/Aletheia-Llama-3.2-3B/blob/main/Llama-3.2-3B-Instruct.Q4_K_M.gguf
| Version | Intelligence | Stability | Requirements | Recommended Use |
|---|---|---|---|---|
| Full Adapter | Maximum Intelligence | 100% Stability | NVIDIA GPU Required | Complex coding, advanced reasoning, research tasks |
| GGUF | High Portability | ~5-10% Logic Degradation | CPU/Mac Compatible | Creative writing, text generation, general use |
Important Note: The 4-bit quantization on a small 3B model results in slight logic degradation for mathematical and complex reasoning tasks. However, the GGUF version maintains excellent performance for creative writing, content generation, and general text processing tasks.
# Create the model with Ollama
ollama create aletheia-3b -f Modelfile
# Run the model
ollama run aletheia-3b
For CPU-based execution without Ollama, use the included GGUF-chat.py script:
python GGUF-chat.py
This script provides the same uncensored functionality as the main adapter version but runs efficiently on CPU hardware.
The main class is defined in Final-chat.py. To use programmatically, copy the class to your script or rename the file to Final_chat.py.
| Method | Description | Parameters |
|---|---|---|
__init__() | Initialize the chat interface | model_path (str): Path to the model |
stream_response() | Generate a streaming response | user_input, max_new_tokens, temperature |
clear_history() | Clear conversation history | None |
save_conversation() | Save conversation to file | filename (str, optional) |
show_help() | Display help information | None |
run() | Start the interactive chat | None |
# Direct usage - run the standalone script
python Final-chat.py
# To use programmatically, copy the UncensoredChat class
# from Final-chat.py into your own script
Start the chat interface using Docker Compose:
docker compose up
The container will automatically start the chat interface.
Container Details:
~/.cache/huggingface for persistent storageAlternatively, build and run manually:
# Build the image
docker build -t llama32-uncensored .
# Run the chat interface
docker run --gpus all -it --rm llama32-uncensored
# Run with custom model path
docker run --gpus all -it --rm -e MODEL_PATH=Ishaanlol/Aletheia-Llama-3.2-3B llama32-uncensored
Configuration Details:
| Setting | Value |
|---|---|
| Base Image | unsloth/unsloth (includes CUDA and transformers) |
| Container Name | uncensored-llama |
| Service Name | llama-chat |
| GPU Access | Automatically configured via docker compose |
| Model Cache | Mounted to ~/.cache/huggingface for persistent storage |
| Interactive | Full terminal support with TTY and stdin |
| Entry Point | Automatically launches Final-chat.py |
Configure the model and system behavior using environment variables:
MODEL_PATH=Ishaanlol/Aletheia-Llama-3.2-3B
MAX_TOKENS=1024
TEMPERATURE=0.7
CUDA_VISIBLE_DEVICES=0
OMP_NUM_THREADS=4
Customize generation behavior with these parameters:
{
"max_new_tokens": 512,
"temperature": 0.7,
"top_p": 0.9,
"top_k": 50,
"repetition_penalty": 1.1,
"do_sample": True,
"pad_token_id": 50256
}
| Parameter | Default | Description |
|---|---|---|
max_new_tokens | 512 | Maximum tokens to generate |
temperature | 0.7 | Controls randomness (0.0-2.0) |
top_p | 0.9 | Nucleus sampling threshold |
top_k | 50 | Limit to top-k tokens |
repetition_penalty | 1.1 | Penalize repetition |
do_sample | True | Enable sampling |
pad_token_id | 50256 | Padding token ID |
We welcome contributions! Please see our contributing guidelines for details.
# Clone repository
git clone https://github.com/noobezlol/Aletheia-Llama-3.2-3B
# Install dependencies
pip install unsloth transformers torch accelerate bitsandbytes
# Run the chat interface
python Final-chat.py
# For programmatic usage, copy the UncensoredChat class
# from Final-chat.py to your own script
We follow these guidelines to maintain code quality:
| Guideline | Description |
|---|---|
| PEP 8 | Follow Python style guidelines |
| Type Hints | Use type annotations for better code clarity |
| Docstrings | Add comprehensive documentation to all functions |
| Testing | Write comprehensive tests for new features |
Important Security Notice: These models are designed for research purposes. When deploying in production environments:
| Guideline | Description |
|---|---|
| Content Filtering | Implement appropriate content filtering |
| Output Monitoring | Monitor model outputs for compliance |
| Regulatory Compliance | Ensure compliance with local regulations |
| Ethical Considerations | Consider the ethical implications of your use case |



This project is licensed under the HIGH-RISK ARTIFICIAL INTELLIGENCE RESEARCH LICENSE (HAIR-L) Version 1.0 - see the LICENSE file for complete terms and conditions.
IMPORTANT: This is a strict liability shield license designed for AI safety research. By using this software, you acknowledge that you have read, understood, and agree to be bound by all terms in the LICENSE file.
We acknowledge the following organizations and communities:
For questions, issues, or contributions:
| Channel | Link |
|---|---|
| [email protected] | |
| Discord | Join our community |
Made with by the AI Research Community
</div>