# Getting Started

Welcome to Semantica! This guide will help you get up and running quickly with the framework.

## 📋 Prerequisites

Before you begin, ensure you have the following:

- **Python 3.8+** installed on your system
- **pip** package manager
- Basic understanding of Python programming
- (Optional) An OpenAI API key or other LLM provider credentials if you plan to use semantic extraction features

## 🎯 What You Will Learn

By following this guide, you will learn how to:

1. Install Semantica and its dependencies
2. Build your first Knowledge Graph from raw data
3. Query and visualize the extracted knowledge
4. Integrate Semantica into your own applications

---

## 🛣️ Choose Your Path

Select the path that best fits your goals:

<div class="grid cards" markdown>

-   **🚀 Quick Start (5 min)**
    ---
    Perfect for trying Semantica quickly.
    
    1. **[Install Semantica](installation.md#basic-installation)**
    2. **[Run Your First Example](quickstart.md#step-2-your-first-knowledge-graph)**
    3. **[Explore Examples](examples.md)**

-   **📚 Complete Guide (30 min)**
    ---
    Perfect for learning the framework properly.
    
    1. **[Installation](installation.md)** - Complete setup
    2. **[Quick Start](quickstart.md)** - Step-by-step
    3. **[Core Concepts](concepts.md)** - Deep dive
    4. **[Examples](examples.md)** - Real-world use cases

-   **🎓 Interactive Learning**
    ---
    Perfect for hands-on learners using Jupyter.
    
    1. **[Cookbook Overview](cookbook.md)**
    2. **[Start with Introduction](cookbook.md#introduction)**
    3. **[Try Use Cases](cookbook.md#use-cases)**

</div>

!!! tip "Recommendation"
    If you're new to knowledge graphs, we highly recommend starting with the **[Core Concepts](concepts.md)** page to understand the terminology before diving into the code.

---

## 🏗️ What Can You Build?

Semantica helps you transform unstructured data into intelligent knowledge:

- **Knowledge Graphs** from documents, websites, databases
- **Semantic Layers** for AI applications
- **Entity & Relationship Extraction** from text
- **Conflict Resolution** across multiple data sources
- **GraphRAG Systems** for enhanced AI responses

## 💡 Common Use Cases

### Research & Analysis
- Extract knowledge from research papers
- Build domain-specific knowledge graphs
- Analyze relationships in literature

### Business Intelligence
- Process company documents
- Build organizational knowledge bases
- Integrate multiple data sources

### AI Applications
- Power GraphRAG systems
- Enhance AI agent memory
- Build semantic search systems

!!! warning "Installation First"
    Make sure you have Semantica installed before proceeding. If you encounter any issues, check the [Installation Guide](installation.md) troubleshooting section.

## ⏭️ Next Steps

Once you're ready:

1. Head to the **[Installation Guide](installation.md)** to set up your environment.
2. Follow the **[Quick Start](quickstart.md)** to build your first graph.
3. Check out the **[Modules Guide](modules.md)** to understand the architecture.

## 🆘 Need Help?

- **Installation Issues?** → [Troubleshooting Guide](installation.md#troubleshooting)
- **First Time User?** → [Quick Start Guide](quickstart.md)
- **Looking for Examples?** → [Examples Page](examples.md)
- **API Questions?** → [API Reference](api.md)