Bienvenido a Oikos¶

Oikos es una biblioteca Python diseñada para estudiantes, economistas y desarrolladores interesados en el análisis económico y la modelización de la teoría económica básica.

Aprovechando el cálculo simbólico, oikos permite resolver problemas de micro y macroeconomía tanto numérica como algebraicamente, facilitando el aprendizaje y la enseñanza de conceptos económicos fundamentales.

Filosofía¶

En un mundo lleno de librerías económicas complejas y orientadas exclusivamente a la estadística avanzada, oikos nace con una misión diferente: hacer que la teoría económica sea tangible, visual y sencilla.

Principios fundamentales¶

Economía para Humanos: No necesitas ser un experto en Python para modelar. Si puedes escribir la ecuación en un papel, puedes usar oikos.
Fidelidad Académica: Usamos la notación que encuentras en tus libros: α, β, γ, λ. El código debe leerse como un libro de texto.
De la Micro a la Macro: Un solo ecosistema para entender desde el excedente de un consumidor hasta el equilibrio general de una nación.
Intuición sobre Datos: Antes de correr regresiones, hay que entender los desplazamientos. oikos es tu tablero digital para experimentar con la teoría.

Características principales¶

Resolución simbólica: Impulsada por SymPy para resolver ecuaciones de equilibrio sin derivación manual
Microeconomía: Calcula el excedente del consumidor/productor, las elasticidades y el equilibrio del mercado
Macroeconomía: Modelos multiplicadores, marco IS-LM y análisis agregado
Teoría del Consumidor: Optimización de utilidad, curvas de indiferencia y demandas hicksianas/marshallianas
Comercio Internacional: Modelos ricardianos, ventajas comparativas, fronteras de posibilidades de producción
Visualización: Gráficos profesionales listos para presentaciones académicas
Documentación matemática: Compatibilidad total con \(\LaTeX\) en nuestra documentación web oficial

Instalación¶

Desde PyPI (recomendado)¶

Si solo deseas explorar la librería o ejecutar ejemplos simples, una instalación básica con pip es suficiente:

pip install oikos

Desde el código fuente¶

Si planeas contribuir o trabajar con la versión de desarrollo:

git clone https://github.com/marcosjuniorhernandez/economy.git
cd economy
pip install -e .

En Google Colab¶

!pip install oikos
from oikos import *

En Jupyter Notebook¶

# En una celda de código
!pip install oikos

Luego reinicia el kernel e importa:

from oikos import *

Requisitos¶

Python 3.8 o superior
Se recomienda el uso de cuadernos como Jupyter Notebook o JupyterLab para aprovechar al máximo las capacidades de visualización

Dependencias¶

oikos instala automáticamente:

numpy - Cálculos numéricos
sympy - Álgebra simbólica
scipy - Optimización científica
latex2sympy2 - Parser LaTeX
matplotlib - Gráficos
ipython - Visualización mejorada
rich - Tablas y salidas formateadas

Ejemplo rápido¶

from oikos import *

# Crear funciones de demanda y oferta
demanda = Demanda("Q = 100 - 2P")
oferta = Oferta("Q = -20 + 3P")

# Calcular el equilibrio
eq = equilibrio(oferta, demanda)
print(eq)  # {'P*': 24.0, 'Q*': 52.0}

# Calcular excedentes
exc = excedentes(oferta, demanda)
print(f"Excedente del Consumidor: {exc['EC']}")
print(f"Excedente del Productor: {exc['EP']}")
print(f"Excedente Social: {exc['ES']}")

# Graficar
demanda.graficar()

Siguiente paso¶

Continúa con el Manual de Uso para explorar todos los módulos y funcionalidades de oikos.

Enlaces útiles¶

PyPI: https://pypi.org/project/oikos/
Repositorio: https://github.com/marcosjuniorhernandez/economy
Email: iam.marcoshernandez@gmail.com