polis-genesis 0.2.0__py3-none-any.whl

polis_genesis/__init__.py

@@ -0,0 +1,5 @@
+"""
+Polis Genesis: Autonomous multi agent society simulation.
+"""
+
+__version__ = "0.2.0"

polis_genesis/__main__.py

@@ -0,0 +1,4 @@
+from polis_genesis.cli import main
+
+if __name__ == "__main__":
+    main()

polis_genesis/cli.py

@@ -0,0 +1,97 @@
+"""
+Command line interface for Polis Genesis.
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+import webbrowser
+
+def find_cli_binary() -> str | None:
+    # Look in cargo target directories
+    candidates = [
+        os.path.join(os.path.dirname(__file__), "..", "..", "target", "release", "polis_cli.exe"),
+        os.path.join(os.path.dirname(__file__), "..", "..", "target", "debug", "polis_cli.exe"),
+        os.path.join(os.path.dirname(__file__), "..", "..", "target", "release", "polis_cli"),
+        os.path.join(os.path.dirname(__file__), "..", "..", "target", "debug", "polis_cli"),
+        shutil.which("polis_cli"),
+        shutil.which("polis_cli.exe"),
+    ]
+    for c in candidates:
+        if c and os.path.exists(c):
+            return os.path.abspath(c)
+    return None
+
+def cmd_console(args: argparse.Namespace) -> None:
+    bin_path = find_cli_binary()
+    if bin_path:
+        subprocess.run([bin_path, "console", str(args.seed), str(args.population), str(args.ticks), str(args.delay)])
+    else:
+        # Fall back to cargo run
+        cmd = ["cargo", "run", "--release", "-p", "polis_cli", "--", "console", str(args.seed), str(args.population), str(args.ticks), str(args.delay)]
+        try:
+            subprocess.run(cmd)
+        except FileNotFoundError:
+            print("cargo was not found. Please install Rust from https://rustup.rs to compile polis_cli.")
+            sys.exit(1)
+
+def cmd_serve(args: argparse.Namespace) -> None:
+    bin_path = find_cli_binary()
+    cmd = [bin_path or "cargo", "serve" if bin_path else "run", *(["--release", "-p", "polis_cli", "--", "serve"] if not bin_path else []), str(args.seed), str(args.population), str(args.port)]
+    try:
+        subprocess.run(cmd)
+    except KeyboardInterrupt:
+        print("\nTown server stopped.")
+
+def cmd_web(args: argparse.Namespace) -> None:
+    url = args.url or "https://eyadstein.github.io/polis-genesis/world.html"
+    print(f"Opening Polis Genesis in browser: {url}")
+    webbrowser.open(url)
+
+def cmd_info(_args: argparse.Namespace) -> None:
+    print("==================================================")
+    print("  Polis Genesis: Society & Mind Simulator")
+    print("  Version: 0.2.0")
+    print("  Repository: https://github.com/eyadstein/polis-genesis")
+    print("  Website: https://eyadstein.github.io/polis-genesis/world.html")
+    print("==================================================")
+    print("  Districts: 16 districts with central water fountains")
+    print("  Needs: Hunger, Thirst, Energy, Social, Purpose")
+    print("  Actions: Eat, Drink, Rest, Work, Socialize, Wander")
+    print("  Economics: Real estate, rents, progressive taxes")
+    print("==================================================")
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="polis-genesis", description="Polis Genesis Autonomous Simulation")
+    subparsers = parser.add_subparsers(dest="command", help="Subcommand to execute")
+
+    p_console = subparsers.add_parser("console", help="Run interactive terminal world")
+    p_console.add_argument("--seed", type=int, default=1, help="World RNG seed")
+    p_console.add_argument("--population", type=int, default=120, help="Initial population")
+    p_console.add_argument("--ticks", type=int, default=500, help="Total simulation ticks")
+    p_console.add_argument("--delay", type=int, default=70, help="Milliseconds between ticks")
+    p_console.set_defaults(func=cmd_console)
+
+    p_serve = subparsers.add_parser("serve", help="Run live town server")
+    p_serve.add_argument("--seed", type=int, default=1, help="World RNG seed")
+    p_serve.add_argument("--population", type=int, default=200, help="Initial population")
+    p_serve.add_argument("--port", type=int, default=8787, help="Server port")
+    p_serve.set_defaults(func=cmd_serve)
+
+    p_web = subparsers.add_parser("web", help="Open the 3D visualizer website")
+    p_web.add_argument("--url", type=str, default=None, help="Target URL")
+    p_web.set_defaults(func=cmd_web)
+
+    p_info = subparsers.add_parser("info", help="Show system and simulation information")
+    p_info.set_defaults(func=cmd_info)
+
+    args = parser.parse_args()
+    if hasattr(args, "func"):
+        args.func(args)
+    else:
+        cmd_info(args)
+
+if __name__ == "__main__":
+    main()

polis_genesis-0.2.0.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: polis-genesis
+Version: 0.2.0
+Summary: A living autonomous multi agent society simulation with neural minds, realistic economics, and 3D visualizer
+Author: Eyad Stein
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eyadstein/polis-genesis
+Project-URL: Documentation, https://eyadstein.github.io/polis-genesis/world.html
+Project-URL: Repository, https://github.com/eyadstein/polis-genesis
+Project-URL: Issues, https://github.com/eyadstein/polis-genesis/issues
+Keywords: simulation,multi-agent,artificial-life,society,neural-network,generative-agents,threejs,rust
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Games/Entertainment :: Simulation
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Polis Genesis
+
+> **An autonomous town simulation where artificial life meets a living
+> 3D world.**
+
+[![ENTER THE WORLD --- Launch Live
+Demo](https://img.shields.io/badge/ENTER_THE_WORLD-Launch_Live_Demo-2ea44f?style=for-the-badge)](https://eyadstein.github.io/polis-genesis/)
+
+[![CI](https://github.com/eyadstein/polis-genesis/actions/workflows/ci.yml/badge.svg)](https://github.com/eyadstein/polis-genesis/actions/workflows/ci.yml)
+[![GitHub
+Pages](https://github.com/eyadstein/polis-genesis/actions/workflows/pages.yml/badge.svg)](https://github.com/eyadstein/polis-genesis/actions/workflows/pages.yml)
+[![MIT
+License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/polis-genesis.svg)](https://pypi.org/project/polis-genesis/)
+
+**[🌐 Open the live simulation
+→](https://eyadstein.github.io/polis-genesis/)**
+
+------------------------------------------------------------------------
+
+## Overview
+
+**Polis Genesis** is a real-time, 3D town simulation built around
+autonomous agents. Each resident has its own genome, needs, moods,
+memories, relationships, and a neural-network-driven mind.
+
+Residents make decisions, work, interact, form families, and participate
+in an evolving virtual society. Rather than relying entirely on scripted
+events, the simulation brings together individual behavior and
+interconnected systems to explore how a virtual society develops.
+
+Try the hosted viewer without installing anything:
+
+**[Enter Polis Genesis](https://eyadstein.github.io/polis-genesis/)**
+
+## Features
+
+-   **Autonomous agents** --- neural-network-driven behavior that learns
+    from experience.
+-   **Needs and daily life** --- food, water, sleep, work, social
+    interaction, and other needs shape decisions.
+-   **Economy** --- jobs, salaries, housing, taxes, and a shared town
+    treasury.
+-   **Families and genealogy** --- relationships, children, genetic
+    inheritance, and mutation.
+-   **Law and order** --- crime, police, courts, fines, and prisons.
+-   **Dynamic environment** --- day/night transitions, seasonal
+    lighting, waterways, fountains, and ambient sound.
+-   **Interactive 3D viewer** --- a browser-based world built with
+    Three.js and Vite.
+-   **Python CLI** --- console, server, and web commands for interacting
+    with the simulation.
+-   **Snapshots and analytics** --- JSON exports, statistical reports,
+    and replay functionality.
+
+## Getting Started
+
+### Try it online
+
+Open the live demo:
+
+**https://eyadstein.github.io/polis-genesis/**
+
+### Install the Python package
+
+``` bash
+pip install polis-genesis
+```
+
+### Run the simulation
+
+Start the console interface:
+
+``` bash
+polis-genesis console
+```
+
+Start the local server:
+
+``` bash
+polis-genesis serve
+```
+
+Open the local viewer address printed by the server. Depending on the
+configuration, it may be available at
+`http://localhost:8787/world.html`.
+
+Launch web mode:
+
+``` bash
+polis-genesis web
+```
+
+## Build from Source
+
+### Prerequisites
+
+-   Rust and Cargo
+-   Node.js and npm
+-   Python for Python tooling
+
+### Run the simulation
+
+From the repository root:
+
+``` bash
+cargo run --release -p polis_cli -- 1 3000 200
+```
+
+### Start the 3D viewer
+
+``` bash
+cd viewer
+npm ci
+npm run dev
+```
+
+Vite prints the local development URL in the terminal.
+
+### Build the production viewer
+
+From the `viewer` directory:
+
+``` bash
+npm run build
+```
+
+The generated static site is written to `viewer/dist`. GitHub Actions
+builds and deploys the viewer to GitHub Pages.
+
+## Technology Stack
+
+  Component                Technology
+  ------------------------ ----------------
+  Simulation engine        Rust
+  3D rendering             Three.js
+  Front-end tooling        Vite
+  Python interface         Python
+  Continuous integration   GitHub Actions
+  Demo hosting             GitHub Pages
+
+## Roadmap
+
+-   [x] Core engine, genomes, needs, moods, and movement
+-   [x] Economy, jobs, and housing
+-   [x] Relationships, children, and inheritance
+-   [x] Memory and social interaction
+-   [x] Law enforcement and justice systems
+-   [ ] Schools, belief systems, culture, and sports
+-   [ ] Expanded survival mechanics and emergent epochs
+-   [ ] Enhanced observation, replay, and analytics
+
+## Documentation
+
+-   [Design overview](docs/DESIGN.md)
+-   [Contributing guidelines](CONTRIBUTING.md)
+-   [Changelog](CHANGELOG.md)
+-   [License](LICENSE)
+
+## Contributing
+
+Contributions, bug reports, and ideas are welcome.
+
+1.  Fork the repository.
+2.  Create a branch for your changes.
+3.  Implement your changes and add tests where appropriate.
+4.  Run the relevant checks.
+5.  Submit a pull request describing your changes.
+
+Run the Rust checks:
+
+``` bash
+cargo test --workspace --all-features --locked
+cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
+```
+
+For viewer changes:
+
+``` bash
+cd viewer
+npm ci
+npm test
+npm run build
+```
+
+## License
+
+Distributed under the [MIT License](LICENSE).
+
+------------------------------------------------------------------------
+
+**Explore the world. Observe the agents. Watch the town evolve.**
+
+**[ENTER POLIS GENESIS →](https://eyadstein.github.io/polis-genesis/)**

polis_genesis-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+polis_genesis/__init__.py,sha256=csltdf_T919KsRB5qusf71kKmhQYqBCwbZeECxlJT-g,89
+polis_genesis/__main__.py,sha256=-0UHikyg1UcQJG9ydDPx1u1uN_TEIxDV6jfj_LI6Swc,74
+polis_genesis/cli.py,sha256=bapcqa_7mOv2Vi-oRcCzCxCuhBLbafXt32K4qx8ntGU,4317
+polis_genesis-0.2.0.dist-info/licenses/LICENSE,sha256=4ZNTs0RLW3NLl1j5QjvZO5mTrX2C8SknemoQE4uQYhY,1066
+polis_genesis-0.2.0.dist-info/METADATA,sha256=GAKobSYMVkcrJ5ajlmlBxcZuT14_lgHfvXMjn3EiFIE,6238
+polis_genesis-0.2.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+polis_genesis-0.2.0.dist-info/entry_points.txt,sha256=jqNTZnVkhpjKpkle6BOCnR3zlN2mltHgiENHVpyO9-Q,88
+polis_genesis-0.2.0.dist-info/top_level.txt,sha256=TkYhitvuDXIsF0Tkna1ltgUjI42U5kXogVRmahWnx8g,14
+polis_genesis-0.2.0.dist-info/RECORD,,

polis_genesis-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

polis_genesis-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+polis = polis_genesis.cli:main
+polis-genesis = polis_genesis.cli:main

polis_genesis-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eyad Ahmed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

polis_genesis-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+polis_genesis