Table of Contents
Introduction
Hugging Face Beginner Guide, If you’re entering the world of Artificial Intelligence and Machine Learning, getting started with Hugging Face is one of the smartest moves you can make in 2025. Hugging Face is a powerful AI platform that provides thousands of pre-trained models for natural language processing (NLP), computer vision, speech recognition, and generative AI applications.
Whether you want to build chatbots, text summarizers, translators, or AI-powered mobile apps, Hugging Face makes it simple with ready-to-use APIs and open-source libraries like Transformers. Developers can experiment with models directly in the browser or integrate them into applications using Python, JavaScript, or REST APIs.
In this Hugging Face Beginner Guide, you’ll learn how to create an account, explore models, use inference APIs, and start building AI-powered applications quickly and efficiently.
All the required steps are specified below
Install Python 3.11 via Homebrew
Install python on machine to implement Hugging Face Beginner Guide
brew install python@3.11
Check Python version
Run python –version or python3 –version in your terminal to verify Python is installed. Make sure you’re using Python 3.8 or higher.
python3 --version
Create a project folder and move into it
Use mkdir project-name to create a new folder. Then navigate into it using cd project-name.
mkdir huggingface_demo cd huggingface_demo
Create a virtual environment
Run python -m venv venv to create an isolated virtual environment. This keeps dependencies separate from your global Python setup.
python3 -m venv hf-env
Activate the virtual environment
On Windows, run venv\Scripts\activate. On macOS/Linux, use source venv/bin/activate.
source hf-env/bin/activate
Upgrade pip and install required packages
Upgrade pip using pip install –upgrade pip. Then install packages like pip install transformers requests.
pip install --upgrade pip pip install requests huggingface-hub
Export your Hugging Face API token
Set your API token using export HUGGINGFACEHUB_API_TOKEN=”your_token” (macOS/Linux). On Windows, use setx HUGGINGFACEHUB_API_TOKEN “your_token”.
export HF_TOKEN="YOUR_HUGGINGFACE_API_TOKEN
Check if it works
echo $HF_TOKEN
Run the Python script
python3 ai.py
deactivate venv
deactivate
Local Model
A local model runs directly on your device or system without needing an internet connection. It offers better privacy and lower latency but depends on your hardware performance.
from transformers import pipeline
generator = pipeline(
"text-generation",
model="gpt2",
device="mps"
)
prompt = "Explain agentic AI in simple terms:"
result = generator(
prompt,
truncation=True,
max_new_tokens=250,
temperature=0.7,
do_sample=True,
)
print("\n🧠 AI Response:\n")
print(result[0]["generated_text"])
print("\n✅ Generation complete.")
Online Model
An online model runs on cloud servers and requires an internet connection to function. It provides higher accuracy and scalability since it uses powerful remote GPUs.
import os
from huggingface_hub import InferenceClient
client = InferenceClient(
api_key=os.environ["HF_TOKEN"],
)
completion = client.chat.completions.create(
model="moonshotai/Kimi-K2-Thinking",
messages=[
{
"role": "user",
"content": "What is the capital of USA?"
}
],
)
print(completion.choices[0].message)
Video Model
A video model processes and understands video content for tasks like object detection, tracking, and video generation. It is commonly used in surveillance, content creation, and AI-powered editing tools.
import os
from huggingface_hub import InferenceClient
client = InferenceClient(
provider="fal-ai",
api_key=os.environ["HF_TOKEN"],
)
video_bytes = client.text_to_video(
"A young man walking on the street",
model="meituan-longcat/LongCat-Video",
)
# Save video locally
output_file = "longcat_output.mp4"
with open(output_file, "wb") as f:
f.write(video_bytes)
print(f"Video saved to {output_file}")
Final Thoughts
Hugging Face Beginner Guide, Setting up your Python environment and configuring your Hugging Face API token properly lays the foundation for building powerful AI applications. With a clean virtual environment and the right dependencies installed, you’re ready to experiment with models, test APIs, and integrate AI into real-world projects.
As you continue, explore different pre-trained models, try fine-tuning, and experiment with inference APIs. The more you practice, the more confident you’ll become in building scalable, production-ready AI solutions