Skip to main content

A wrapper for NEMOTRON chat and images API, Accountless!

Project description

🧠 Nemotron4Free

Nemotron4Free is a lightweight Python wrapper for the NEMOTRON chat API. It allows you to send prompts and receive responses easily — with optional streaming support.

⚠️ No authentication or API key is required — the NEMOTRON API currently accepts any request, so Nemotron4Free works without login or account setup.


🚀 Installation

Install from PyPI:

pip install Nemotron

Or from source:

git clone https://github.com/Ramona-Flower/Nemotron4Free.git
cd Nemotron4Free
pip install .

💡 Usage

Basic Example

from Nemotron import ask

response = ask("What's the capital of France?")
print(response)

Streaming Output

from Nemotron import ask

response = ask("Tell me a sci-fi story.", stream=True)

With stream=True, the response is printed live as it's received — and also returned as a full string at the end.

🧠 Model Selection

You can choose which model to use by passing the model parameter:

from Nemotron import ask

response = ask("Hello, who are you?", stream=True, model="claude3_5") # nemotron70b by default

Available Models

Model Name Description Streaming Supported
nemotron70b Default model (Used by default) ✅ (stream=True)
claude3_5 Anthropic Claude 3.5 ✅ (stream=True)
gpt4o OpenAI GPT-4 Omni ✅ (stream=True)

Claude 3.5 need premium account !

🔧 Parameters

Parameter Type Default Description Info
content str Your prompt or message to the AI. Work with nemotron70b, claude3_5, gpt4o
stream bool False If True, prints the output live as it streams. Work withnemotron70b, claude3_5, gpt4o
model str nemotron70b Specifies which model to use. Can be nemotron70b, claude3_5, or gpt4o. Nothing to say
name str "test" Your name (optional). This is not required for the API but can be included for context. Useful for claude
email str "test@gmail.com" Your email (optional). This is not required for the API but can be included for context. Useful for claude

🧪 Example Output

User: Tell me a joke
AI: Why don't scientists trust atoms?
    Because they make up everything.

🖼️ Image Generation

Nemotron4Free also supports image generation. To use this feature, you must provide a valid email address. Without a valid email, the API will reject the request.

Example: Generate an Image

from Nemotron import generate_image

img_url = generate_image(
    prompt="A futuristic city in the clouds",
    model="black-forest-labs/flux-1.1-pro",
    ratio="16:9",
    format_="jpg",
    email="your_valid_email@example.com"  # Replace with a valid email
)

if img_url:
    print(f"Image URL: {img_url}")
else:
    print("Failed to generate the image. Please check your email or other parameters.")

Available Models for Image Generation

Model Name Description
black-forest-labs/flux-dev Development version of Flux
black-forest-labs/flux-pro Professional version of Flux
black-forest-labs/flux-schnell Fast version of Flux
black-forest-labs/flux-1.1-pro Flux 1.1 Pro version
black-forest-labs/flux-schnell Another fast version of Flux

Parameters for Image Generation

Parameter Type Default Description
prompt str The description of the image you want to generate.
model str The model to use for image generation.
ratio str 1:1 Aspect ratio of the image (e.g., 16:9, 4:3).
format_ str png The format of the image (e.g., jpg, png).
email str A valid email address required for image generation.
  • ratio : 1:1 - 16:9 - 9:16 - 3:2 - 2:3

✨ Author

Created with ❤️ by Ramona-Flower

⭐ Feel Free to Star!

📄 License

Apache 2.0 License.

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

nemotron-0.1.1.tar.gz (4.6 kB view details)

Uploaded Source

File details

Details for the file nemotron-0.1.1.tar.gz.

File metadata

  • Download URL: nemotron-0.1.1.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for nemotron-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d856c1e7aa451f8e24cf4ad19cc05582e685371dc675ccbc5479ab65dfeaa800
MD5 f879ad7fcf185915762a1fb636bb3ffb
BLAKE2b-256 f0f22fabd7e4499ee4a3d0cd09e714263520ac79bc3d6b16efa4dc0f62719c32

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