> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/python/cpython/llms.txt
> Use this file to discover all available pages before exploring further.

# CPython Documentation

> The reference implementation of the Python programming language

<div className="relative overflow-hidden bg-gradient-to-br from-[#2a4d73] via-[#2a4d73] to-[#1a3a5a] dark:from-[#1a3a5a] dark:via-[#2a4d73] dark:to-[#2a4d73] py-20">
  <div className="max-w-6xl mx-auto px-6 lg:px-8">
    <div className="grid grid-cols-1 lg:grid-cols-12 gap-12 items-center">
      <div className="lg:col-span-7">
        <h1 className="text-4xl sm:text-5xl lg:text-6xl font-bold text-white mb-6">
          Welcome to CPython Documentation
        </h1>

        <p className="text-lg sm:text-xl text-gray-200 dark:text-gray-300 max-w-2xl mb-8">
          The complete guide to Python's reference implementation — from getting started to advanced internals. Learn the language, explore the standard library, and dive into C API development.
        </p>

        <div className="flex flex-wrap gap-4">
          <a href="/quickstart" className="inline-flex items-center px-6 py-3 rounded-lg font-semibold bg-[#ffcc33] text-black hover:bg-[#f0c419] transition-colors">
            Get Started
          </a>

          <a href="/introduction" className="inline-flex items-center px-6 py-3 rounded-lg font-semibold border-2 border-white/30 bg-white/10 text-white hover:bg-white/20 transition-colors">
            Read Introduction
          </a>
        </div>
      </div>

      <div className="hidden lg:block lg:col-span-5">
        <img src="https://media.brand.dev/0ec66409-5f18-473e-b01f-89b7bc474db2.png" alt="Python logo" noZoom className="w-full h-auto max-w-sm mx-auto opacity-90" />
      </div>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">
    Quick start
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Get Python up and running on your system in minutes
  </p>

  <Steps>
    <Step title="Download Python">
      Get the latest Python release from [python.org](https://www.python.org/downloads/) or build from source.

      ```bash theme={null}
      # On Unix/Linux/macOS
      ./configure
      make
      make test
      sudo make install
      ```
    </Step>

    <Step title="Verify Installation">
      Check that Python is installed correctly by running:

      ```bash theme={null}
      python3 --version
      ```

      <Accordion title="Expected output">
        ```
        Python 3.15.0a6
        ```
      </Accordion>
    </Step>

    <Step title="Run Your First Program">
      Create a simple Python script and run it:

      ```python hello.py theme={null}
      print("Hello, World!")
      ```

      ```bash theme={null}
      python3 hello.py
      ```
    </Step>

    <Step title="Explore Further">
      Continue with the [tutorial](/tutorial/interpreter) to learn Python fundamentals, or dive into the [standard library](/library/overview) to discover built-in modules.
    </Step>
  </Steps>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">
    Explore by topic
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Find what you need across tutorials, reference docs, and internals
  </p>

  <CardGroup cols={3}>
    <Card title="Python Tutorial" icon="graduation-cap" href="/tutorial/interpreter">
      Learn Python from the ground up with our comprehensive tutorial series
    </Card>

    <Card title="Language Reference" icon="book" href="/reference/lexical-analysis">
      Formal specification of Python syntax, semantics, and execution model
    </Card>

    <Card title="Standard Library" icon="cube" href="/library/overview">
      Explore 200+ built-in modules for everything from file I/O to networking
    </Card>

    <Card title="C API Reference" icon="code" href="/c-api/intro">
      Extend and embed Python using the comprehensive C API
    </Card>

    <Card title="CPython Internals" icon="microscope" href="/internals/structure">
      Deep dive into the interpreter, compiler, and runtime implementation
    </Card>

    <Card title="How-To Guides" icon="lightbulb" href="/howto/regex">
      Practical guides for common Python programming tasks
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">
    Popular modules
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Most commonly used modules in the Python standard library
  </p>

  <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
    <a href="/library/os" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#fbde58] dark:hover:border-[#fbde58] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27] p-6">
      <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">
        os — Operating System Interface
      </h3>

      <p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
        Interact with the operating system: file operations, environment variables, process management
      </p>

      <span className="text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#fbde58] flex items-center gap-1">
        View module

        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </span>
    </a>

    <a href="/library/sys" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#fbde58] dark:hover:border-[#fbde58] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27] p-6">
      <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">
        sys — System-specific Parameters
      </h3>

      <p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
        Access interpreter variables, command-line arguments, and system-level configuration
      </p>

      <span className="text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#fbde58] flex items-center gap-1">
        View module

        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </span>
    </a>

    <a href="/library/asyncio" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#fbde58] dark:hover:border-[#fbde58] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27] p-6">
      <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">
        asyncio — Asynchronous I/O
      </h3>

      <p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
        Write concurrent code using async/await syntax for high-performance applications
      </p>

      <span className="text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#fbde58] flex items-center gap-1">
        View module

        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </span>
    </a>

    <a href="/library/pathlib" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#fbde58] dark:hover:border-[#fbde58] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27] p-6">
      <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">
        pathlib — Object-oriented Filesystem Paths
      </h3>

      <p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
        Modern, intuitive API for working with file paths across platforms
      </p>

      <span className="text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#fbde58] flex items-center gap-1">
        View module

        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </span>
    </a>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">
    Resources
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Connect with the Python community and contribute to development
  </p>

  <CardGroup cols={2}>
    <Card title="Contributing Guide" icon="hands-helping" href="/contributing/setup">
      Learn how to contribute to CPython development
    </Card>

    <Card title="GitHub Repository" icon="github" href="https://github.com/python/cpython">
      View source code, report issues, and submit pull requests
    </Card>

    <Card title="Python Discourse" icon="comments" href="https://discuss.python.org/">
      Join discussions with the Python community
    </Card>

    <Card title="Developer's Guide" icon="book-open" href="https://devguide.python.org/">
      Complete guide for CPython core developers
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="rounded-2xl border border-gray-200 dark:border-[#27272a] bg-gradient-to-br from-[#2a4d73]/5 to-[#fbde58]/5 dark:from-[#2a4d73]/20 dark:to-[#fbde58]/10 p-8 md:p-12">
    <h2 className="text-2xl md:text-3xl font-bold text-gray-900 dark:text-white mb-4">
      Ready to start with Python?
    </h2>

    <p className="text-base text-gray-600 dark:text-gray-400 mb-6 max-w-2xl">
      Follow our quickstart guide to install Python and run your first program, or jump into the tutorial to learn the language from scratch.
    </p>

    <a href="/quickstart" className="inline-flex items-center px-6 py-3 rounded-lg font-semibold bg-[#2a4d73] dark:bg-[#fbde58] text-white dark:text-black hover:bg-[#1a3a5a] dark:hover:bg-[#f0c419] transition-colors">
      Get Started Now
    </a>
  </div>
</div>