AlternativeInternet

A framework for generating fictional alternative internet experiences that explore how the web might have evolved under different technological and cultural scenarios.

AlternativeInternet generates immersive fictional web experiences based on different technological and design scenarios. It uses language models to create content that simulates alternative internet histories and interfaces, from retrofuturist computing to mystical networks.

• Sample and Custom Fictional Scenarios: Includes Retrofuturist, Etherweave, Cyberpunk, and Solarpunk scenarios as samples and allows users to create custom scenarios.
• Dynamic Content Generation: Creates realistic HTML webpages using language models, including by leveraging the Cerebras API for ultra-fast generation.
• Image Generation: Custom imagery that matches each alternative scenario, generated using the Flux Schnell model on the FAL API for ultra-fast image generation.

• Python 3.8+
• pip package manager

1. Clone the repository:

git clone https://github.com/k-zubi/alternative-internet.git
cd alternative-internet

2. Install dependencies:

pip install -r requirements.txt

3. Set up environment variables: Create a .env file in the project root with your API keys:

OPENAI_API_KEY=your_openai_api_key      # If using OpenAI
CEREBRAS_API_KEY=your_cerebras_api_key  # If using Cerebras
FAL_KEY=your_fal_api_key                # For image generation

python main.py

This will start the web server on port 8080. Navigate to http://localhost:8080 in your browser to view the application.

python chat.py

The application dynamically generates pages based on the URL paths:

1. The main entry point is at the root URL (/), which shows the home page for the current scenario
2. All other URLs are handled by a catch-all route that generates content based on the path
3. Pages follow a typical web structure like /tld/domain/page/subpage
4. Links within pages direct to other pages within the same fictional internet scenario
5. The application handles image requests automatically, generating scenario-appropriate imagery

Access the admin interface at http://localhost:8080/admin to:

1. View Current Scenario: See which alternative internet scenario is currently active
2. Switch Scenarios: Choose from available scenarios (Etherweave, Retrofuturist, Cyberpunk, Solarpunk)
3. Add Custom Scenarios: Create your own alternative internet scenario by providing:
   • Scenario Name: A unique identifier for your scenario
   • Short Description: Brief explanation of the scenario
   • Full Scenario Description: Detailed guidelines for content generation

A "Browse Current Scenario" link takes you back to the main application with your selected scenario active.

AlternativeInternet/
├── main.py               # Flask application entry point
├── chat.py               # Chat interface
├── image_generator.py    # Generates scenario-specific images
├── lm/                   # Language model clients
│   ├── base_lm_client.py       # Abstract base client interface
│   ├── openai_lm_client.py     # OpenAI implementation
│   └── cerebras_lm_client.py   # Cerebras implementation
├── prompts/              # Configuration for different scenarios
│   ├── retrofuturist.json
│   ├── etherweave.json
│   ├── cyberpunk.json
│   ├── solarpunk.json
│   └── scenario_manager.py
└── image_cache/          # Cached images

This project is licensed under the MIT License.