Skip to content

Latest commit

 

History

History
108 lines (83 loc) · 2.82 KB

README.md

File metadata and controls

108 lines (83 loc) · 2.82 KB

NeonCore

image

Welcome to NeonCore - A Text-Based Cyberpunk RPG

Dive into the neon-soaked streets of Night City in this immersive text-based role-playing game. As a cyberpunk operative, navigate through a world of corporate intrigue, street-level conflicts, and high-tech warfare.

Features:

  • Choose your role: Become a street-smart Netrunner, a combat-ready Solo, or other unique characters
  • Deep character customization with detailed lifepaths and backgrounds
  • Dynamic skill-based gameplay system
  • Text-based exploration of Night City's various districts
  • Engaging NPC interactions and encounters
  • Command-line interface with cyberpunk aesthetic

Built with Python, NeonCore delivers a classic RPG experience inspired by the Cyberpunk 2020 tabletop game system. Use your skills, cyber-enhancements, and street smarts to survive and thrive in the dark future of 2045.

Installation & Usage

Standard Installation (Linux/MacOS)

  1. Clone the repository to your local machine
  2. Install using pip:
    pip install -e .
  3. Run the game:
    python run_game.py

Windows with msys2

  1. Create fresh virtual environment:
python -m venv venv
  1. Allow PowerShell script execution:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  1. Activate virtual environment:
./venv/bin/Activate.ps1
  1. Upgrade pip:
python -m pip install --upgrade pip
  1. Install OpenAI using pre-built wheels only:
python -m pip install openai --no-build-isolation --only-binary :all:
  1. Run the game:
python run_game.py

AI Chat Features

NeonCore includes an AI chat system that lets you interact with NPCs. The system supports two backends:

Using Grok API

Set up your environment variables:

# Windows PowerShell
$env:XAI_API_KEY="your-api-key-here"

# Linux/MacOS
export XAI_API_KEY="your-api-key-here"

Using Ollama

  1. Install Ollama:
curl -fsSL https://ollama.com/install.sh | sh
  1. Download the smollm2 model (271MB):
ollama pull smollm2:135
  1. Set Ollama host (default is http://localhost:11434):
# Windows PowerShell
$env:OLLAMA_HOST="http://localhost:11434"

# Linux/MacOS
export OLLAMA_HOST="http://localhost:11434"

In-Game Chat

Use the talk command to chat with NPCs. For example:

ᐸ/> talk Hey Judy, what's the word on the street about the latest cyberware?
Judy: Hey there, V! Word on the street is there's some nova chrome hittin'
the black market. Heard about this new neural booster that's supposed to
jack your processing speed through the roof. But watch yourself - corps
are crackin' down hard on unauthorized tech these days.